.NET「找不到類型或命名空間」錯誤排查清單

Visual Studio 提示 CS0246: 找不到類型或命名空間名稱 'X'，通常是以下四大類原因。

1. 參考遺漏 (最常見)

• 專案 → 參考 → 右鍵「加入參考」 → 勾選缺少的組件 (DLL/專案/COM/NuGet 套件)。
• 若為 NuGet 套件，嘗試「還原 NuGet 套件」或重新安裝。

2. 命名空間拼寫/大小寫錯誤

• C# 區分大小寫：System.Collections.Generic ≠ system.collections.generic。
• 使用 using 完整命名空間，或在類型前加完整命名空間前綴。

3. 目標框架不相容

• 專案目標 .NET Framework 4.7.2，參考的 DLL 卻是 .NET Standard 2.0 / .NET Core 3.1，可能缺少相容性包。
• 右鍵專案 → 屬性 → 應用程式 → 目標框架，確認一致。

4. 類型存取層級非 public

• 若參考的類別宣告為 internal class Foo (預設)，外部專案無法看見。
• 修改為 public class Foo 或加上 [assembly: InternalsVisibleTo("YourProject")]。

快速診斷步驟

1. 查看「錯誤清單」詳細輸出，確認是哪個檔案、哪一行、哪個識別碼。
2. 將滑鼠停在紅波浪線上，IDE 會提示潛在修正 (如「加入 using...」、「安裝套件...」)。
3. 建置輸出視窗 (Build Output) 往往比錯誤清單更詳細，檢查 CSC 編譯器參數與參考路徑。
4. 清理解決方案 → 重新建置，排除殘留快取干擾。

進階：Analyzer / Roslyn 診斷

安裝 Microsoft.CodeAnalysis.NetAnalyzers NuGet 套件，可在編譯時靜態分析更多潛在問題。

依序檢查上述四點，90% 以上情況可解決。若仍無法解決，請提供完整錯誤訊息、專案結構截圖與目標框架版本。