導入：なぜ「拡張機能推奨」が重要なのか
チーム開発において、最も頭を悩ませる問題の一つが「開発環境の差異」です。「自分の環境では動くのに、別の人の環境では動かない」というトラブルの多くは、IDEのプラグインや設定の不一致に起因します。特に、LinterやFormatterが統一されていないと、不要な差分がGit上で発生し、コードレビューの効率を大きく下げてしまいます。VS Codeの「拡張機能推奨」機能を使えば、プロジェクトを開いた瞬間に必要なツールを自動で提案できるため、新規参画者のオンボーディングコストを最小限に抑えることが可能です。
基礎知識：extensions.jsonとは
VS Codeには、プロジェクト単位で推奨する拡張機能を管理する「.vscode/extensions.json」という設定ファイルが存在します。このファイルに拡張機能のIDを記述することで、VS Codeはそのプロジェクトに適したツールを自動認識します。これにより、チームメンバー全員が同じエディタ環境で開発を進める「環境統一」が可能になります。
実装：設定ファイルの作成手順
設定は非常にシンプルです。プロジェクトルートに「.vscode」というディレクトリを作成し、その中に「extensions.json」というファイルを作成します。JSON形式で「recommendations」というキーに対して、インストールしてほしい拡張機能のIDを配列形式で記述するだけです。
拡張機能のIDは、VS Codeの拡張機能マーケットプレイスで対象の拡張機能を開き、詳細画面の「共有」アイコンから「拡張機能のIDをコピー」を選択することで取得できます。
サンプルプログラム：extensions.jsonの記述例
以下は、Webフロントエンド開発で一般的に推奨されるツールを定義した例です。この内容を「.vscode/extensions.json」として保存してください。
{
// チーム開発で推奨する拡張機能のリスト
“recommendations”: [
// ESLint: JavaScript/TypeScriptの静的解析ツール
“dbaeumer.vscode-eslint”,
// Prettier: コードフォーマッター（自動整形）
“esbenp.prettier-vscode”,
// GitLens: Gitの履歴表示や詳細な分析を支援するツール
“eamodio.gitlens”
]
}
応用・注意点：現場で役立つ運用のコツ
1. 強制インストールとの使い分け
「recommendations」はあくまで「推奨（通知）」ですが、さらに強く制御したい場合は「unwantedRecommendations」を使うことで、特定の拡張機能を「このプロジェクトでは使用を推奨しない」という設定も可能です。
2. 拡張機能のバージョン固定
拡張機能そのものは自動インストールされますが、設定ファイルで細かなルールを定義したい場合は、併せて「.vscode/settings.json」も活用しましょう。例えば、Prettierの保存時自動整形（formatOnSave）などは、設定ファイル側で記述しておくことで、個人の設定に依存せず全員の環境でルールを適用できます。
3. 注意点
拡張機能を増やしすぎると、エディタの起動速度が低下します。本当に「チーム全員にとって必須」と言えるものだけに絞って記載するのが、快適な開発環境を保つための秘訣です。
コメント