Unityでスクリプトを書こうとしたとき、いきなり手が止まる瞬間ってありますよね。
「MonoBehaviourが出てこない」「GameObjectの候補が出ない」「using UnityEngineに赤線がつく」―― コードを書く前に、エディター側でつまずいてしまうケースです。
実はこれ、かなり多くの人が一度は経験するトラブルです。しかもやっかいなのが、コードが間違っているわけではないことが多いという点なんですよね。
私も最初は「自分の書き方がおかしいのかな？」と思って、何度もコードを書き直していました。でも原因はまったく別で、Unityとエディターの“連携”がうまくいっていなかっただけでした。
この問題の本質はシンプルで、UnityとVisual Studio（またはVS Code）が正しくつながっていないことにあります。
ただし原因は1つではなく、
- Unity側の設定ミス
- プロジェクトファイルの不整合
- エディター側の環境不足
といった複数のパターンがあり、順番を間違えると遠回りしやすいです。
ここでは「どこから確認すればいいか」「どう判断すればいいか」を軸に、迷わず解決できる流れで整理していきます。
一度この流れを理解しておくと、今後同じようなトラブルが起きてもすぐに対応できるようになりますよ。
結論
結論からいうと、Unityで補完が効かないときは「順番」がとても大事です。
多くの人がやりがちなのが、いきなり再インストールしたり、コードを疑ったりすること。でも実際は、もっとシンプルな原因で止まっているケースがほとんどです。
まずは次のチェックリストを上から順番に確認してみてください。
最短チェックリスト
- Unityの外部スクリプトエディターが正しく設定されているか確認する
- 「Regenerate project files」を実行する
- Visual Studio Editorパッケージが導入・更新されているか確認する
- Visual Studio / VS Code側の必要機能が入っているか確認する
- それでも直らない場合は.csproj / .slnを再生成する
この順番で確認すれば、ほとんどのケースは解決できます。
やるべきこと・後回しでよいこと
| 優先度 | やること | 理由 |
|---|---|---|
| 高 | UnityのExternal Tools設定確認 | 連携が切れていると補完が機能しない |
| 高 | プロジェクトファイルの再生成 | 参照エラーの多くはこれで解決する |
| 中 | IDEの設定・拡張機能確認 | 環境不足で補完が動かないことがある |
| 低 | 再インストール | 設定が原因なら意味がないことが多い |
特に初心者の方ほど「再インストールすれば直るのでは？」と思いがちですが、これは最後の手段です。
症状から原因をざっくり判断するコツ
- 補完が一切出ない → UnityとIDEの連携が切れている可能性が高い
- using UnityEngineだけ赤線 → 参照ファイルの不整合を疑う
- C#の補完は出るがUnityだけ出ない → プロジェクトファイルやパッケージの問題
ここを見分けられるようになると、「どこを直せばいいか」が一気に分かるようになります。
次は、実際に自分の症状がどのパターンに当てはまるのか、もう少し具体的に切り分けていきましょう。
原因を切り分けよう｜補完が効かない症状別の見分け方
次にやるべきことは、「自分の症状がどのタイプか」を見極めることです。
ここを曖昧なまま対処を始めると、関係ない設定をいじってしまって遠回りしがちなんですよね。
代表的なパターンごとに原因の方向性を整理していきます。
「using UnityEngine;」に赤線が出る場合
この症状はかなり多いですが、結論からいうとコードのミスではない可能性が高いです。
using UnityEngine;
public class PlayerMove : MonoBehaviour
{
}
このような基本コードで赤線が出る場合、疑うべきは以下です。
- .csprojファイルの不整合
- Unity APIの参照がIDEに渡っていない
- Unityプロジェクトとして正しく認識されていない
特に多いのが「プロジェクトファイルのズレ」です。Unity自体は問題なく動くのに、IDEだけエラーを出す状態になります。
MonoBehaviourやGameObjectが補完されない場合
この場合はUnityとエディターの連携がうまくいっていない可能性が高いです。
- External Script Editorが未設定
- Visual Studio Editorパッケージが未導入・古い
- VS Codeの拡張機能が不足している
特徴としては、「Unity関連の候補だけ出ない」状態になります。
逆に、stringやListなどのC#標準補完が出ているなら、エディター自体は動いています。問題はUnityとの連携部分です。
C#の補完は出るがUnity APIだけ出ない場合
これは少しややこしいですが、半分だけ正常な状態です。
C#の補完が出ている＝エディターの言語機能は動いている Unityの補完が出ない＝Unityの情報が読み込めていない
この状態の原因は主に以下です。
- .slnや.csprojが古い・壊れている
- Unityからエディターを開いていない
- Unityプロジェクトのルートを開いていない（VS Codeで多い）
中級者向けの視点としては、「C#補完」と「Unity API補完」は別物と考えると理解しやすいです。
Unity APIの候補は、Unityが生成したプロジェクト情報をもとにIDEが補完しています。なので、この橋渡しが壊れるとUnity系だけ出なくなるんですね。
ここまでで自分の症状がどれに近いか見えてきたら、次はUnity側の設定から順番に直していきましょう。
Unity側の設定を直す｜External Toolsとプロジェクトファイル再生成
ここまでで「連携が怪しそう」と分かったら、まず最初に確認すべきはUnity側の設定です。
なぜここが重要かというと、Unityが「どのエディターを使うか」を正しく認識していないと、そもそも補完に必要な情報が渡らないからです。
External Script Editorを正しく選ぶ
まずはUnityのエディター設定を確認します。
- Unityで「Edit ＞ Preferences」を開く（Macは「Unity ＞ Settings」）
- 「External Tools」を選択
- 「External Script Editor」を確認
- 使用するエディター（Visual Studio / VS Code）を明示的に選択
ここで注意したいのが、「Open by file extension」のままにしないことです。
この状態だと、OSの関連付けでエディターは開きますが、Unityとの連携機能が正しく働かないことがあります。
「Visual Studio 2022」や「Visual Studio Code」といった具体的なアプリを選ぶのがポイントです。
Regenerate project filesを実行する
次にやるべきなのが、プロジェクトファイルの再生成です。
- 同じく「External Tools」を開く
- 必要に応じて「Generate all .csproj files」にチェック
- 「Regenerate project files」をクリック
- スクリプトをダブルクリックしてエディターを開き直す
この操作は、Unityとエディターをつなぐ「橋」を作り直すイメージです。
実際、この1ステップだけで直るケースはかなり多いです。
特に以下の症状がある場合は効果的です。
- using UnityEngineに赤線が出る
- Unity APIの補完が出ない
- 急に補完が効かなくなった
よくある失敗｜エディターだけ再起動してしまう
ありがちなのが、「Visual Studioだけ再起動」「VS Codeだけ再起動」で様子を見るパターンです。
これだと、Unity側の設定やプロジェクト情報が更新されないので、状況が変わらないことが多いです。
ポイントは、必ずUnity側から設定→再生成→スクリプトを開き直すという流れで操作することです。
ちなみに、スクリプトの基本的な作成方法や開き方があいまいな場合は、こちらも参考になります。
Unity側の設定が整ったら、次はエディター側の環境を確認していきましょう。
Visual Studioを使う場合の直し方｜Unity開発ワークロードを確認する
Visual Studioを使っている場合、補完が効かない原因の多くは「必要な機能が入っていない」ことです。
見た目は普通に使えていても、Unity開発に必要なコンポーネントが不足していると、IntelliSenseが正しく動きません。
Visual Studio InstallerでUnity用ワークロードを確認する
まずはVisual Studioのインストール内容を確認します。
- 「Visual Studio Installer」を起動する
- 使用中のVisual Studioを選択して「変更」をクリック
- 「Unityによるゲーム開発」にチェックが入っているか確認
- 入っていなければチェックを入れてインストール
この「Unityによるゲーム開発」には、以下のような重要な機能が含まれています。
- Unity用のデバッグ機能
- Unity APIの補完サポート
- プロジェクト連携機能
ここが抜けていると、Unityのスクリプトとして正しく認識されないことがあります。
Visual Studioで起きやすい症状
ワークロード不足の場合、次のような状態になりやすいです。
- MonoBehaviourに赤線が出る
- UnityEngineが認識されない
- 補完がほとんど出てこない
- Unityから開いてもただのC#ファイルとして扱われる
このときのポイントは、「エディターは動いているが、Unityプロジェクトとして認識されていない」という状態です。
再インストール前に確認するべきこと
ここでありがちなのが、「Visual Studioを入れ直せば直るのでは？」と考えてしまうことです。
ただし、ワークロードが入っていない状態で再インストールしても、同じ状態が再現されるだけです。
それよりもまずは、
- Unity用ワークロードが入っているか
- Unityからスクリプトを開いているか
- .slnファイルを正しく開いているか
この3つを確認する方が確実です。
もしVisual Studioの動作がどうしても不安定な場合は、別のIDEを使うという選択肢もあります。
たとえば「JetBrains Rider」はUnityとの相性がよく、設定で悩みにくいエディターとして知られています。
ただし、まずは今の環境を正しく整えることが優先です。ここを理解しておくと、どのエディターを使っても応用が効くようになりますよ。
VS Codeを使う場合の直し方｜拡張機能と.NET SDKを確認する
VS Codeは軽くて便利なエディターですが、その分「自分で環境を整える必要がある」のが特徴です。
Visual Studioと違って、インストールしただけではUnity開発に必要な機能が揃っていないことが多いので、ここをしっかり確認していきましょう。
Unity用の拡張機能を確認する
まずはVS Codeの拡張機能です。最低限、以下の構成になっているかをチェックします。
- Unity（Microsoft製）
- C# Dev Kit
最近の環境では、Unity拡張を入れるとC# Dev Kitも一緒に導入されるケースが多いです。
ここでありがちなミスが、「昔のC#拡張（OmniSharp）だけ入っている状態」です。
古い構成でも動く場合はありますが、環境によっては補完が不安定になることがあります。
もし複数のC#関連拡張が入っている場合は、一度整理するのも有効です。
.NET SDKは環境に合ったバージョンを確認する
VS Codeでは、C#の補完は.NET SDKに依存しています。
ここで注意したいのが、「特定のバージョンが絶対必要」というわけではない点です。
重要なのは、インストールしている拡張機能が対応しているSDKが入っているかです。
- SDKが未インストール → C#補完自体が動かない
- バージョンが合っていない → 補完が不安定になることがある
不安な場合は、使用している拡張機能の公式ページを確認するのが確実です。
VS Codeでよくある失敗例
VS Code特有のトラブルもいくつかあります。
- Unityプロジェクトのルートではなく「Assetsフォルダだけ」を開いている
- Unity側でExternal Script EditorがVS Codeになっていない
- .csprojファイルを再生成していない
特に「フォルダの開き方」は見落とされがちです。
VS Codeでは、プロジェクトのルートフォルダ（AssetsやProjectSettingsがある階層）を開く必要があります。
ここを間違えると、Unityプロジェクトとして認識されず、補完が効かなくなります。
症状からの判断ポイント
- C#の補完すら出ない → SDKやC#拡張の問題
- C#補完は出るがUnityだけ出ない → Unity連携や.csprojの問題
VS Codeは自由度が高い分、原因の切り分けが少し難しいですが、逆に言えば「どこが原因か分かれば確実に直せる」構造でもあります。
ここまで確認しても改善しない場合は、プロジェクトファイル自体をリセットする方法を試していきましょう。
それでも直らない時の対処法｜.csproj・.sln・キャッシュを再生成する
ここまでの設定を確認しても補完が直らない場合は、プロジェクト内部のファイルが壊れている可能性があります。
このとき有効なのが、「Unityが自動生成するファイルを一度リセットする」方法です。
少し強めの対処ですが、正しく手順を踏めば安全に実行できます。
削除してよいファイル・注意が必要なフォルダ
まず、削除対象を整理しておきましょう。
- .csproj ファイル（複数ある場合あり）
- .sln ファイル
- .vs フォルダ（隠しフォルダ）
これらはすべて、UnityやVisual Studioが自動生成するファイルです。
つまり、削除してもUnityを再起動すれば再び作られます。
一方で注意が必要なのがこちらです。
- Library フォルダ
これも再生成可能ですが、削除するとプロジェクトの再インポートが発生し、環境によってはかなり時間がかかります。
まずは削除せず、最後の手段として考えるのがおすすめです。
安全な再生成手順
実際の手順は次の通りです。
- Unity、Visual Studio、VS Codeをすべて閉じる
- プロジェクトフォルダのバックアップを取る（念のため）
- .csproj / .sln / .vs フォルダを削除する
- Unityを起動してプロジェクトを開く
- 「Regenerate project files」を実行する
- スクリプトをダブルクリックしてエディターを開く
この流れで、UnityとIDEの連携情報が完全にリセットされます。
「何をやっても直らなかったのに、これで一発で直った」というケースも珍しくありません。
Libraryフォルダ削除は最後の手段にする
それでも改善しない場合のみ、Libraryフォルダの削除を検討します。
ただし、ここは少し慎重に扱いたいポイントです。
- プロジェクトの再インポートが走る
- 大規模プロジェクトだと数十分かかることもある
- キャッシュが消えるため、一時的に動作が重くなる
まずは軽いリセット（.csproj / .sln）で様子を見て、それでもダメなら実行する、という順番がおすすめです。
なお、こういった「内部ファイルの不整合」は、ビルドエラーやクラッシュの原因にもつながることがあります。
コチラの記事も参考になります。
ここまででほとんどのケースは解決できますが、最後に「よくある勘違い」も整理しておきましょう。
よくある誤解・注意点｜補完エラーとコードエラーを混同しない
ここまで設定を見直しても不安が残る場合、多くの人がハマるのが「エラーの見方の勘違い」です。
特に初心者のうちは、エディターに赤線が出ると「コードが間違っている」と思いがちですよね。
でも実際は、補完エラーとコードエラーはまったく別物です。
補完が効かないだけなら、コードが間違っているとは限らない
たとえば、こんな状況です。
- using UnityEngineに赤線が出ている
- MonoBehaviourが認識されていない
- でもUnityでは普通に再生できる
この場合、Unity側では問題なくコンパイルできている可能性が高いです。
つまり、「IDEの表示だけがおかしい状態」です。
このときにコードを書き直しても、ほとんど意味がありません。
まず疑うべきは、今回解説してきたような「連携や設定の問題」です。
Unity ConsoleのエラーとIDEの赤線は分けて考える
判断のコツはシンプルです。
- Unity Consoleにエラーが出ている → コードや参照設定も確認する
- Unity Consoleは正常、IDEだけ赤線 → IDE側の問題を疑う
この切り分けができるようになると、かなり無駄な試行錯誤が減ります。
エラー全般の見方が不安な場合は、こちらも参考になります。
セキュリティソフトや同期フォルダも影響することがある
これは頻度は高くありませんが、環境によっては影響するケースがあります。
- OneDriveやDropbox配下にプロジェクトがある
- セキュリティソフトがファイルアクセスを制限している
こういった場合、プロジェクトファイルの生成や更新がうまくいかず、結果として補完が不安定になることがあります。
ただしこれはすべての環境で起こるわけではないため、あくまで「他の原因で直らないときの候補」として考えるのがちょうどいいです。
ここまで理解できていれば、「なぜ補完が効かないのか」はかなりクリアになっているはずです。
まとめ｜補完が効かない時は、コードより先に連携設定を確認しよう
今回のポイントをまとめると、Unityで補完が効かない原因は「コード」ではなく「環境」にあることがほとんどです。
特に大事なのは、次の順番で確認することでした。
- UnityのExternal Tools設定を確認する
- プロジェクトファイル（.csproj / .sln）を再生成する
- Visual StudioやVS Codeの環境を整える
- それでもダメならファイルをリセットする
この流れを押さえておくだけで、「何から手をつければいいか分からない」という状態はほぼなくなります。
私自身も最初は「コードの書き方が悪いのかな？」と悩んでいたのですが、実際は環境の問題だったことがほとんどでした。
一度この仕組みを理解しておくと、今後似たトラブルが起きても冷静に切り分けできるようになります。
補完が直ると、コードを書くスピードもかなり上がりますし、ミスも減ります。開発のストレスもぐっと減るので、ここはしっかり整えておきたいポイントです。
もし「エディター作業をもっと快適にしたい」と感じてきたら、Inspectorの拡張なども検討してみると便利ですよ。
Odin Inspector
✅ アセットストアでチェックする
開発環境が整うと、Unityでできることが一気に広がります。ここを乗り越えたら、あとはどんどん作っていきましょう 🙂
よくある質問（FAQ）
- QVisual StudioとVS Code、初心者はどちらを使うべき？
- A
迷った場合は、まずVisual Studioから始めるのがおすすめです。
理由はシンプルで、Unity開発に必要な機能が「まとめて入る」からです。
- Visual Studio → ワークロードを入れるだけで環境が整う
- VS Code → 拡張機能やSDKを自分で組み合わせる必要がある
VS Codeは軽くて自由度が高いですが、その分トラブル時の切り分けが少し難しくなります。
「まずはスムーズに開発を始めたい」という場合はVisual Studio、慣れてきてからVS Codeに移行するのも良い選択です。
- Qusing UnityEngineに赤線が出てもUnityでは動くのはなぜ？
- A
これはよくある状態で、UnityとIDEの認識がズレていることが原因です。
Unity側では正常にコンパイルできているためゲームは動きますが、IDE側では参照が解決できていないためエラー表示になります。
この場合はコードの問題ではなく、次のどれかが原因であることが多いです。
- .csproj / .slnファイルの不整合
- プロジェクトファイルの再生成がされていない
- Unityとエディターの連携設定がズレている
今回紹介した手順で修正すれば、ほとんどの場合は解消できます。
- Q補完が直らない時、Unityを再インストールすべき？
- A
基本的にはおすすめしません。
補完の問題は、Unity本体よりも「設定」や「プロジェクトファイル」が原因になっているケースが多いからです。
再インストールしても、
- External Toolsの設定
- エディター側の環境
- .csprojの状態
これらが変わらなければ、同じ問題がそのまま残ることもあります。
まずはこの記事で紹介した手順を一通り試して、それでも解決しない場合に最終手段として検討するのが安心です。
※当サイトはアフィリエイト広告を利用しています。リンクを経由して商品を購入された場合、当サイトに報酬が発生することがあります。
※本記事に記載しているAmazon商品情報（価格、在庫状況、割引、配送条件など）は、執筆時点のAmazon.co.jp上の情報に基づいています。
最新の価格・在庫・配送条件などの詳細は、Amazonの商品ページをご確認ください。