IntelliJ IDEAで「自分専用の魔法」を創る：カスタム言語プラグイン開発の入り口
こんにちは。現場で泥臭いコードと格闘しているエンジニアの皆さん、お疲れ様です。
日々、業務で使っている「独自DSL（ドメイン固有言語）」。設定ファイルや社内ルールを記述するあの言語、エディタ上でただの「白い文字」として扱っていませんか？ 構文エラーは実行するまで分からず、補完も効かない。そんな不毛な時間に、そろそろ終止符を打ちましょう。
IntelliJ IDEAの本質は、単なるJava/KotlinのIDEではありません。「あらゆる言語の構文を理解し、操作するためのプラットフォーム」です。今回は、IntelliJ Platform SDKを使い、あなたのDSLをIDEの「第一級市民」へと昇格させる方法を伝授します。
—
1. なぜ「プラグイン開発」が必要なのか？
多くのエンジニアが「構文ハイライトくらいなら、VS Codeの拡張機能でいいのでは？」と考えます。しかし、IntelliJの真価は「静的解析の深さ」にあります。
IntelliJのプラグインは、単に色を付けるだけではありません。
- PSI (Program Structure Interface): ソースコードをツリー構造としてメモリ上に構築し、言語の「意味」を理解させる。
- Resolve & Completion: どこから定義が参照されているか、どの変数が有効かをIDEが把握し、爆速のナビゲーションを実現する。
これらを実装することで、あなたのDSLは単なるテキストから、リファクタリング可能で、型安全な「プログラム」へと進化します。
—
2. 開発環境のセットアップ：IntelliJ Platform Plugin Template
車輪の再発明は避けましょう。JetBrains公式が提供している [IntelliJ Platform Plugin Template](https://github.com/JetBrains/intellij-platform-plugin-template) を使うのが、最も賢明なルートです。
準備するもの
1. IntelliJ IDEA Ultimate または Community
2. JDK 17以上
3. Gradle (テンプレートに含まれます)
まずは、GitHub上のテンプレートを「Use this template」ボタンから自分のリポジトリにコピーし、クローンしてください。
—
3. Hello World：カスタム言語をIDEに認識させる
プラグイン開発の第一歩は、あなたの言語を「ファイルタイプ」として登録することです。
手順1: 言語定義 (`Language.java`)
まず、あなたの言語を識別するための中心となるクラスを作成します。
// MyLanguage.java
// 言語のID（一意であること）を定義します。
public class MyLanguage extends Language {
public static final MyLanguage INSTANCE = new MyLanguage();
private MyLanguage() {
super(“MyCustomDSL”); // IDE内で識別される言語名
}
}
手順2: ファイルタイプ登録 (`FileType.java`)
IDEに「この拡張子のファイルは、この言語として扱え」と伝えます。
// MyFileType.java
public class MyFileType extends LanguageFileType {
public static final MyFileType INSTANCE = new MyFileType();
private MyFileType() {
super(MyLanguage.INSTANCE);
}
@Override
public String getName() { return “My Custom DSL File”; }
@Override
public String getDescription() { return “My DSL language file”; }
@Override
public String getDefaultExtension() { return “mydsl”; } // .mydsl 拡張子を対象にする
@Override
public Icon getIcon() { return AllIcons.FileTypes.Text; }
}
手順3: `plugin.xml` への登録
プラグインの心臓部である `src/main/resources/META-INF/plugin.xml` に設定を書き込みます。
—
4. 精度を高めるための「 PSI 」の理解
ここからが本番です。IDEにあなたの言語の構造を教えるために、「Lexer（字句解析）」と「Parser（構文解析）」を実装します。
IntelliJでは、Grammar-Kit というプラグインを使うのが現代の定石です。`.bnf` ファイルという形式で文法を記述するだけで、Javaのコードを自動生成してくれます。
- Lexer: テキストを「トークン（キーワード、変数、数値）」の列に分解します。
- Parser: トークンの列を「ツリー（構文木）」に組み立てます。
このツリーさえ構築できれば、IDEは「今、ユーザーがカーソルを置いているのは『関数名』の定義位置だな」と判断できるようになり、自動補完やCtrl+Clickによる定義ジャンプが魔法のように動き始めます。
—
5. 実務に計り知れない利益をもたらすために
あなたがこのプラグインを完成させた瞬間、チームには以下の変化が訪れます。
1. ヒューマンエラーの消滅: コンパイル時や実行前にIDEが赤波線（エラー警告）を出して止めてくれる。
2. オンボーディングの劇的短縮: 独自DSLの仕様書を読む必要はありません。Ctrl+Spaceを押せば、次に書くべきことがIDEが教えてくれるからです。
3. レガシーからの脱却: 「何がどこで使われているか分からない」という恐怖から解放され、安全にDSLをリファクタリングできるようになります。
—
最後に：まずは小さな一歩から
最初は難しく感じるかもしれません。しかし、IntelliJのSDKは、世界で最も洗練されたIDE構築基盤です。あなたが書いた数行のコードが、何万行ものDSLを管理する強力なツールに化ける快感は、一度味わうと病みつきになります。
まずは、テンプレートをクローンして `.mydsl` ファイルを開き、アイコンが変わるのを確認するところから始めてみてください。
「IDEを支配する者は、開発を支配する」。
あなたの開発ライフが、より創造的で快適なものになることを心から応援しています。何か詰まったら、いつでもPSIの深淵を覗きに来てくださいね。