Unityの外部エディタ設定｜VS Codeの補完と接続

UnityのC#ファイルを開くエディタは、PreferencesのExternal ToolsにあるExternal Script Editorで選びます。

ただし、ファイルが開くことと、Unityの型の補完・エラー診断・デバッグが使えることは別なので、症状を分けて確認します。

この記事は2026年10月5日に確認したUnity 6.3公式マニュアル、Visual Studio Editor 2.0.28の文書、MicrosoftのVS Code連携案内に基づきます。

Unityや各エディタでの新しい実行検証・画面撮影は行っておらず、以下は英語UI名を使った公式仕様上の確認手順です。

最初に「開かない・補完しない・デバッグできない」を分ける

症状	最初に確認する場所	確認したい状態
C#ファイルが別のアプリで開く	UnityのExternal Script Editor	目的のエディタの実行ファイルが選択されている
開くがUnityの型を補完しない	Unity側パッケージとエディタ側の連携機能	対象プロジェクトの情報が読み込まれている
補完は動くがブレークポイントで止まらない	デバッガーの接続先と実行中のコード	対象のUnity Editorへ接続している
入力すると右の文字が消える	エディタの上書きモード	補完やUnityパッケージと別の入力設定

拡張機能不足と決めつけて再インストールする前に、Unityの版、連携パッケージの版、使うエディタ、どの操作で失敗するかを控えます。

エディタ別の連携条件

エディタ	Unity側	エディタ側
Visual Studio（Windows）	Visual Studio Editor：com.unity.ide.visualstudio	Visual Studio Tools for Unity
Visual Studio Code	Visual Studio Editor 2.0.20以上	MicrosoftのUnity拡張と、C#・C# Dev Kitの依存機能
JetBrains Rider	JetBrains Rider Editor：com.unity.ide.rider	Rider本体を外部エディタとして指定

この表はUnity 6.3のIDE対応表を整理したもので、どのエディタを選んでも同じ操作画面になるという意味ではありません。

特にVS Codeで使うUnity側のパッケージ名は、Visual Studio Code EditorではなくVisual Studio Editorです。

旧パッケージcom.unity.ide.vscodeは公式にサポート終了とされているため、現行の連携手順と混同しないでください。

既存プロジェクトで入れ替える場合は、変更前のパッケージ名・版とPackagesの設定ファイルを保存し、必要な互換性を確認してから変更します。

MicrosoftのVS Code連携手順はUnity 2021以上を前提とし、Microsoft製のUnity拡張を導入するとC# Dev Kitを含む依存機能も導入されると説明しています。

3種類の拡張を必ず個別に検索して入れるのではなく、導入後に依存機能が有効になっているかを確認します。

External Script Editorで開くアプリを指定する

WindowsではEdit → Preferences、macOSではUnity → Settingsを開き、External Toolsを選びます。

External Script Editorで使うアプリを選び、候補にない場合はBrowseでインストール済みエディタの実行ファイルを指定します。

UnityのProjectウィンドウで対象のC#スクリプトをダブルクリックし、意図したアプリとファイルが開くかを確認します。

この段階で確認できるのはファイルを開く連携であり、補完やデバッグの成功までは意味しません。

元へ戻す場合は、変更前に控えたExternal Script Editorの選択へ戻します。

補完の確認とプロジェクトファイルの再生成

まずUnity側の連携パッケージとエディタ側の機能を確認し、別プロジェクトのウィンドウで編集していないかを確かめます。

Unityが生成する.csprojと.slnはIDEにプロジェクト情報を渡すためのもので、C#ファイルを単独で開く操作とは区別します。

Visual Studio Editorの設定では、External ToolsのRegenerate project filesを実行すると、設定に応じて既存.csprojの更新と必要な.csprojの作成が行われます。

再生成後にUnityからスクリプトを開き直し、Unityの型やメンバーが候補に出るかを確認します。

パッケージのコードを参照したい場合は、Generate .csproj files forの対象も確認します。

項目	生成対象のパッケージ等
Embedded packages	プロジェクトに埋め込まれたパッケージ
Local packages	プロジェクト外のローカルリポジトリから追加したもの
Registry packages	Unityまたはカスタムレジストリから追加したもの
Git packages	Git URLで追加したもの
Built-in packages	Unityの標準インストールに含まれるもの
Tarball packages	ローカルのGZip tarballから追加したもの
Unknown packages	Unityが導入元を判定できないもの
Player projects	Player向けの追加.csproj

項目名と動作はVisual Studio Editor 2.0.28の設定文書に基づき、別の連携パッケージや版では表示を確認してください。

Unknown packagesは導入元を判定できない区分であり、危険なパッケージを検査する機能ではありません。

これらはIDE向けファイルの生成対象を選ぶ設定で、パッケージのインストールや削除を行うスイッチではありません。

再生成だけでコードのコンパイルエラーが直るとは限らないため、まだ失敗する場合はUnity ConsoleとIDEのエラー内容を分けて確認します。

設定を戻すときは、変更したチェック項目を元に戻して再生成し、手書きの.csファイルやAssetsを削除する手順には進みません。

VS Codeのデバッグと、入力トラブルの切り分け

MicrosoftのUnity拡張の標準構成では、F5でそのプロジェクトのUnity Editorへアタッチするデバッグを開始します。

確認するときは実行される箇所にブレークポイントを置き、接続先が意図したEditorかを確かめて、そのコードを通る操作を行います。

ビルド済みPlayerへの接続は別の対象なので、Editorで止まらない問題と同じ接続先のまま扱わず、公式のAttach Unity Debuggerの案内を確認します。

この手順での停止や変数確認は今回実測していないため、設定が合っているだけでデバッグ成功とは扱いません。

Visual Studioで文字入力時に右側の文字が消える場合は、上書きモードの解除方法を確認してください。

Unity側パッケージの導入はPackage Managerの使い方、Unity側のコンパイルエラーはSafe Modeとエラー確認へ進むと、確認範囲を分けられます。

確認する順番のまとめ

開くアプリの指定、連携パッケージと拡張、プロジェクト情報、デバッグ接続先の順に確認すると、どの段階で失敗しているかを整理できます。

相談するときはUnityとIDEの版、連携パッケージの版、操作とエラー文をそろえると、拡張を入れ直す前に原因を絞り込めます。