Unity C# 腳本報錯：缺少 UnityEngine 命名空間引用解決方法

問題現象

Unity 項目中 C# 腳本編譯報錯，提示找不到類型或命名空間（如 MonoBehaviour, GameObject 等），通常伴隨紅色波浪線提示。

根本原因

項目缺少對 UnityEngine.dll 的引用，或腳本未正確導入 Unity 命名空間。

解決步驟

1. 在 Visual Studio / Rider 中右鍵項目 →「Add Reference」（添加引用）。
2. 在「Assemblies」→「Framework」中勾選 UnityEngine（若列表無，需手動瀏覽到 Unity 安裝目錄 Editor/Data/Managed/UnityEngine.dll）。
3. 確保腳本頂部包含：

using UnityEngine;
using System.Collections;

常見誤區

• 刪除或移動了 Unity 生成的 .csproj / .sln 文件，導致引用丟失。
• 使用外部 IDE 時未啟用「Unity 集成」插件，無法自動同步引用。

驗證方法

重新編譯項目，錯誤消失且代碼提示恢復正常即表示修復成功。