IntelliJ IDEA 2026.1 Help

組み込みの IDE マクロ

IntelliJ IDEA には、 外部ツール実行構成のパス、オプション、その他のコマンドライン引数を定義するために使用できる変数である、組み込み マクロが多数用意されています。 マクロをサポートするダイアログフィールドには、その横にプラスアイコン が表示されます。

IDE マクロを追加する

マクロの値は現在のコンテキストに依存します。 例: 現在のファイルを含むディレクトリ名を挿入するには、 $FileDirName$ を使用します。 ディレクトリへのフルパスを挿入するには、 $FileDir$ を使用します。

マクロ

説明

$WORKSPACE_DIR$

現在のプロジェクトが属するワークスペースへのパス。 ワークスペースは、開いているファイル階層のルートであり、複数のプロジェクトを含めることができます。

$PROJECT_DIR$

run.json が配置されているプロジェクトのルート。 プロジェクトは通常、Maven プロジェクトや Node.js プロジェクトなどのアプリケーションを開発および構築するためのファイルのコレクションです。

$USER_HOME$

ユーザーのホームディレクトリ。

$FILE$

現在のファイルへの絶対パス (拡張子を含む)。

$AffectedModuleNames$

現在のファイルに関連する モジュールの名前をコンマで区切ったものです。

$Classpath$

プロジェクトの完全なクラスパス。

$ClasspathEntry$

現在のファイルに関連するクラスパスのエントリ。

$ClipboardContent$

システムクリップボードの現在の内容。

$ColumnNumber$

現在のファイルでキャレットが配置されている列番号。

$ContentRoot$

現在のファイルが属する コンテンツルートへのパス。

$FileClass$

現在のファイルで定義されているクラスの名前。

$FileDir$

現在のファイルを含むディレクトリへの絶対パス。

$FileDirName$

現在のファイルを含むディレクトリの名前。

$FileDirPathFromParent(dir)$

パラメーター dir として指定された親ディレクトリを基準にした現在のファイルを含むディレクトリへのパス。

Argument 1: /Users/jetbrains/myProjects/FileDirPathFromParent/ Argument 2: 1

$FileDirRelativeToProjectRoot$

モジュールの コンテンツルートに関連する現在のファイルを含むディレクトリへのパス。

$FileDirRelativeToSourcepath$

ソースパスルートを基準にした現在のファイルを含むディレクトリへのパス。

$FileEncoding$

現在のファイルの エンコーディング

$FileExt$

現在のファイルの拡張子。

$FileFQPackage$

現在のファイルの完全修飾パッケージ名。

例: com.example.mypackage.MyClass の場合、パッケージの完全修飾名は com.example.mypackage です。

$FileName$

現在のファイルの名前(すべての拡張子を含む)。

$FileNameWithoutAllExtensions$

拡張子のない現在のファイルの名前。 これは、ファイルの拡張子が重複している場合に役立ちます。 ピリオドとそれに続くすべてのものが削除されます。

例: ファイルが hello.txt.txt の場合、 $FileNameWithoutAllExtensions$ マクロは hello を返します。

$FileNameWithoutExtension$

拡張子のないファイルの名前。 これにより、ピリオドの 1 回だけが削除され、その後に延長が続きます。

例: ファイルが hello.txt.txt の場合、 $FileNameWithoutExtension$ マクロは hello.txt を返します。

$FilePackage$

現在のファイルの即時パッケージ名(完全修飾ではありません)。

例: com.example.mypackage.MyClass の場合、パッケージの名前は mypackage です。

$FileParentDir$

現在のファイルが置かれているディレクトリへの親ディレクトリの名前。

$FilePath$

現在のファイルへの絶対パス。

$FilePathRelativeToProjectRoot$

モジュールの コンテンツルートに関連する現在のファイルへのパス。

$FilePathRelativeToSourcepath$

ソースパスルートを基準にした現在のファイルへのパス。

$FilePrompt$

ファイルを選択するためのファイルシステムダイアログを表示します。

$FileRelativeDir$

モジュールの コンテンツルートを基準にして、現在のファイルが配置されているディレクトリへのパス。

$FileRelativePath$

モジュールの コンテンツルートに関連する現在のファイルへのパス。

$IsMake$

コンパイルが make で実行された場合、 true を返します。

$JavaDocPath$

JavaDoc 出力ディレクトリ。

$JDKPath$

プロジェクトの JDK へのパス。

$LineNumber$

現在のファイルでキャレットが配置されている行番号。

$ModuleFileDir$

現在のモジュールファイルが配置されているディレクトリへの絶対パス。

$ModuleFilePath$

現在のモジュールファイルへの絶対パス。

$ModuleName$

拡張子のない現在のモジュールファイルの名前。

$ModuleSdkPath$

現在のモジュールの JDK へのパス。

$ModuleSourcePath$

現在のモジュールのソースパス。

$OSName$

小文字のオペレーティングシステム名。

最初のスペース文字まで切り詰められた System.getProperty("os.name") の値を返します。 特定のバージョンは含まれず、 windowsmaclinux などの OS ファミリのみが含まれます。

$OutputPath$

現在のモジュールの出力パス。

$Password$

パスワードを指定するためのダイアログを表示します。 $Prompt$ と似ていますが、入力はマスクされます。

オプションでコロンの後に追加してプロンプトテキストを指定することもできます。例:: $Password:API token$

$ProjectFileDir$

現在のプロジェクトディレクトリへの絶対パス。

$ProjectName$

現在のプロジェクトディレクトリの名前。

$Projectpath$

現在のプロジェクトのソースパス。

$Prompt$

任意の文字列を渡すためのダイアログを表示します。

オプションでプロンプトテキストとデフォルト値をコロンで区切って指定することもできます。例:: $Prompt:Username:Alice$

$RemoteProjectFileDir$

リモートサーバー上のプロジェクトディレクトリへの絶対パス。

$SelectedText$

エディターで現在選択されているテキスト。

$SelectionEndColumn$

選択が終了する列番号。

$SelectionEndLine$

選択が終了する行番号。

$SelectionStartColumn$

選択が開始される列番号。

$SelectionStartLine$

選択が開始される行番号。

$Sourcepath$

プロジェクトの完全なソースパス。

$SourcepathEntry$

現在のファイルに関連するソースパスのエントリ。

$TempDir$

一時ファイルのディレクトリ。

Windows では、 %TEMP% 環境変数の値を返すか、ユーザーのホームディレクトリ内の AppData\Local\Temp (System.getProperty("user.home") によって返される) にフォールバックします。

他のオペレーティングシステムでは、 $TempDir$ /tmp を返します。

$UnixSeparators(path)$

パラメーターとしてパスを取り、すべての区切り文字をスラッシュに変換します。

例: $UnixSeparators(\foo\bar)$/foo/bar を返します。

プロジェクト外のリソースへのパス

パス変数を使用して、プロジェクト外のリソースを参照できます。 マクロを追加するのと同じ方法で、変数の前後にドル記号を付けて、構成済みのパス変数を追加します (例: $MY_VAR$)。

新しいパス変数を作成する

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | パス変数 を選択します。

    パス変数ダイアログ
  2. 追加ボタン をクリックし、変数の名前と値を入力し、 OK をクリックして変更を適用します。

カスタムマクロ

com.intellij.ide.macro.Macro 拡張ポイントを使用して、プラグインのカスタムマクロを定義できます。 その後、マクロを plugin.xml に登録します。

<macro implementation="full.macro.class.Name"/>

利用可能な拡張ポイントの詳細については、「IntelliJ プラットフォームプラグイン SDK ドキュメント(英語) 」を参照してください。

2026 年 3 月 30 日