ASP.NET 跨專案引用類別失效：專案引用與命名空間檢查清單

常見錯誤原因

1. 未加入專案參考：僅將 .cs 檔複製到專案，**未在「參考」→「加入參考」→「專案」勾選目標專案**。
2. 命名空間不符：目標類別所在命名空間與 using 引入的不一致 (大小寫、拼字)。
3. 目標專案未建置**：引用專案輸出的 DLL 為舊版或不存在。
4. 目標 Framework 不相容**：如 .NET Framework 4.8 專案引用 .NET Core / .NET 5+ 類別庫 (需改用 .NET Standard 或同框架)。

標準解決步驟

1. 方案總管 → 右鍵「參考」→「加入參考」。
2. 左側選「專案」→ 勾選目標專案 (如 MyLib) → 確定。
3. 在使用類別的 .cs 檔頂端加入 using MyLib.Namespace; (確認大小寫)。
4. **重新建置方案** (Ctrl+Shift+B)。

程式碼範例

// 專案 A: MyLib
namespace MyLib.Models {
    public class User {
        public string Name { get; set; }
    }
}

// 專案 B: WebApp
using MyLib.Models; // 引入命名空間

public class HomeController : Controller {
    public ActionResult Index() {
        User u = new User { Name = "Tom" }; // 正常使用
        return View(u);
    }
}

進階：NuGet 套件化 (跨方案共用)

若多個方案共用同一類別庫，建議將目標專案打包為 NuGet 套件 (內建 dotnet pack 或 nuget pack)，發布至私有 NuGet Server (Azure Artifacts, MyGet, 本地資料夾)，其他專案透過 Install-Package MyLib 參考，享受版本管理與還原自動化。