MCL for Visual Studio Code
.mclファイルのSyntax HighlightingとLanguage Server機能を提供するVisual Studio Code拡張です。Language ServerはMCL CLIのmcl lspを起動して利用します。診断、補完、定義への移動、Rename、ドキュメント整形を利用できます。
インストール
MCL CLIを最新リリースからインストールし、mclコマンドをPATHから実行できる状態にします。拡張のVSIXは次のコマンドで生成できます。
pnpm install
pnpm run package
生成されるファイルはmcl-vscode-0.1.0.vsixです。VS CodeのExtensionsビューのメニューから「Install from VSIX...」を選択してインストールします。
設定
| 設定 |
初期値 |
説明 |
mcl.server.path |
mcl |
MCL実行ファイルのpath。PATH上の名前または絶対pathを指定します。 |
mcl.server.args |
["lsp"] |
Language Server起動時に実行ファイルへ渡す引数です。 |
mcl.trace.server |
off |
LSP通信ログの出力レベルです。messagesまたはverboseを指定すると、OutputのMCL Language Server channelに記録します。 |
CLIをPATH以外の場所に配置した場合は、ワークスペース設定で実行ファイルを指定します。
{
"mcl.server.path": "${workspaceFolder}/bin/mcl",
"mcl.server.args": ["lsp"]
}
mcl.server.pathのPATH名はPATHから検索し、絶対pathはそのまま使います。相対pathと${workspaceFolder}は先頭のworkspace folderを基準に解決します。複数folderを開いている場合もLanguage Serverは1つだけ起動し、先頭folderの設定と作業ディレクトリを使います。workspace folderがない場合、相対pathはVS Code Extension Hostの作業ディレクトリを基準にします。${workspaceFolder}を指定した状態でworkspace folderがない場合は起動エラーを表示します。
Windowsではmcl.server.pathにmcl.exeのpathを設定します。
Commands
MCL: Restart Language ServerはLanguage Serverを再起動します。
MCL: Show Language Server OutputはLanguage Serverのログを表示します。
開発
mise installでmise.tomlが指定するMCL CLIを含む開発ツールをインストールしてから、pnpm run test:integrationを実行します。統合テストはPATH上のmclコマンドを起動し、診断と整形を確認します。
mise install
pnpm install
pnpm run compile
pnpm run lint
pnpm run format:check
pnpm run test
pnpm run test:integration
pnpm run package