# 言語と参照のインジェクション

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

言語インジェクションを使用すると、ファイルのメイン言語とは異なるプログラミング言語のコードを操作できます。

文字列リテラルに言語 (HTML、CSS、XML、RegExp など) を挿入すると、それがプロジェクトのメイン言語でなくても、挿入されたコードに対する包括的なコーディング支援が得られます。

IDE は、言語インジェクションに加えて、文字列リテラルをクラスやファイルなどの他のエンティティへの参照として扱う参照インジェクションもサポートしています。

## 言語インジェクションを追加する

Procedure: 永続的な言語インジェクションを追加する

言語インジェクションコメント (アノテーション) を使用して、インジェクションされた言語の永続的なフラグメントを追加します。

* ターゲット文字列リテラルの前に空白行を追加し、次のコメントを入力してください：

```SHELL
// language=<language_ID>

```

コメントは、挿入したい言語のコメント構文ではなく、追加するファイルのコメント構文で記述してください。 言語 ID は、たとえばインジェクション可能な言語のリストで CLion が表示する言語名と異なる場合があります。

言語 ID を見つけるには、コメント内の  `language=`  の後にキャレットを置き、 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) を押します。 補完リストには、すべてのインジェクション可能な言語の ID が、丸括弧内の言語名とともに表示されます。

設定で言語 ID を確認することもできます。 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `エディター | 言語インジェクション`  を選択します。 言語のインジェクションルールをダブルクリックすると、言語 ID が   ID   フィールドに指定されます。

* (オプション) コメントに接頭辞または接尾辞を含めます。

```SHELL
// language=<language_ID> prefix=<prefix> suffix=<suffix>
```

これは次の場合に必要です:

* 文字列は不完全 / 部分的な SQL 文です

* 文字列は、サポートされている呼び出し（ `select /where)` など）で直接使用されていません。

## 挿入された言語フラグメントを編集する

CLion を使うと、インジェクトされた言語フラグメントを専用エディターで編集できます。

Procedure: フラグメントエディターを開く

1. 挿入されたコード部分にキャレットを置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押してください（または インテンションアクション アイコン ![intention action icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) を使用してください）。

2. <言語 ID> フラグメントの編集   を選択します。

CLion は、インジェクションされた言語でコードを編集するための専用エディターセクションを開きます。 このエディターは、コード補完、インスペクション、インテンションアクション 、コードスタイルアクションなど、完全なコーディング支援機能を提供します。

> **Note:**
> コードを編集する際、接頭辞と接尾辞はフラグメントエディターでのみ表示されます。 メインエディターには表示されません。

## 参照を挿入する

参照インジェクションは、文字列リテラルをファイルなどの他のエンティティへのリンクとして解釈します。

例:  `resources/config.json`  はファイルへの参照として扱うことができます。

Procedure: 一時的な参照インジェクションを追加する

1. 参照を挿入したい文字列リテラル内にキャレットを置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押してください（または インテンションアクション アイコン ![intention action icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) を使用してください）。

2. 言語または参照の挿入解除または挿入解除の解除   を選択し、たとえば次のオプションを選択してください：

* ファイル参照 : 指定されたファイルへの参照を追加します。

インストールされているプラグインによっては、他の参照オプションも利用できる場合があります。

Procedure: 永続的な参照インジェクションを追加する

コメントを使用して永続的な参照インジェクションを追加します。

* ターゲット文字列リテラルの前に空白行を追加し、必要な値を含む  `// language=`  コメントを入力します。

* `// language=file-reference` はファイルへの参照を追加します。

## インジェクションをキャンセルする

Procedure: 永続的な言語インジェクションをキャンセルする

言語インジェクションをキャンセルするには、それを導入するために使用したコメント (アノテーション) を削除します。

Procedure: 一時的な言語挿入をキャンセルする

1. キャレットをコード箇所に置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押してください（または インテンションアクション アイコン ![the intention action button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) を使用してください）。

2. 言語または参照の挿入解除   を選択します。

Procedure: インテンションアクションバルブアイコンを無効にする

エディターでインテンションアクションアイコン ![インテンションアクションアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) を非表示にするには、次の手順を実行します。

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `エディター | 一般 | 外観`  を選択します。

2. インテンションバルブを表示する   チェックボックスをオフにします。

3. 変更を適用し、ダイアログを閉じます。

## 自動インジェクションのルールを構成する

CLion には、IDE がコード内の特定の場所に自動的に言語を挿入するための事前定義されたルールのセットがあります。

エディター | 言語インジェクション   設定ページ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) で言語インジェクションルールを設定できます。

定義済みのすべてのインジェクションルールは   ビルトイン   スコープ用に設定されています。 言い換えれば、それらはグローバルです（つまりすべての CLion プロジェクトで利用できます）。 カスタムルールは IDE または 1 つのプロジェクトに対してのみ設定できます。 カスタムインジェクションの範囲を変更するには、 ![「プロジェクト/IDE スコープへ移動」ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.import.svg) を使用してください。

VCS を介してカスタムルールを共有するには、ツールバーの対応するオプションを使用して、カスタムルールを   プロジェクト   スコープに移動します。 そうすることで、バージョン管理下に置くことができるカスタムルールを使用して  `IntelliLang.xml`  という名前の新しいファイルを  `.idea`  ディレクトリに作成します。

VCS を使用しない場合は、ルールを XML ファイルにエクスポートして(ツールバーの ![エクスポート](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.export.svg) をクリック)、別のプロジェクトにインポートすることで、ルールを共有できます。

カスタムインジェクションルールを設定するには、 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいルールを追加するか、あらかじめ定義されたルールをコピーして設定を変更します。

## See also

### リファレンス

[言語インジェクション](language-injections-settings.html)

