Visual Studio 同方案專案參考 vs DLL 參考：Go To Definition 導航差異解析

同一 Solution 內，專案參考 與 DLL 檔案參考 在 Go To Definition (F12) 行為上截然不同。

情境重現

• Solution: Api
• Class Library: Api.Data (含 Entity 類別)
• Web Project: Api.Web

方式一：專案參考 (Project Reference) ✅

Api.Web → 右鍵 References → Add Reference → Projects → 選 Api.Data

• F12 導航至 原始碼：可見完整實作、私有欄位、屬性存取器。
• 支援編輯繼續、中斷點對應源碼行號。

方式二：DLL 參考 (Browse to Api.Data.dll) ❌

Api.Web → Add Reference → Browse → 選 Api.Data\bin\Debug\Api.Data.dll

• F12 導航至 中繼資料：僅顯示公用簽章、自動屬性，看不到私有欄位與方法本體。
• 偵錯時無法進入源碼（除非對應 .pdb 且路徑匹配）。

對比輸出

最佳實踐

同方案內永遠使用專案參考。僅在引用外部無源碼庫、NuGet 套件、或跨方案共用已編譯組件時才用 DLL 參考。