ASP.NET 開發八大最佳實踐：版本控制、強名稱、效能、安全與部署規範

最佳實踐清單

1. 組件版本控制策略

每次建置自動產生版本號，`AssemblyInfo.cs` 設定：

[assembly: AssemblyVersion("1.0.*")] // 自動生成 Build/Revision
// 或手動控制
[assembly: AssemblyVersion("1.2.3.4")]
[assembly: AssemblyFileVersion("1.2.3.4567")]

• `AssemblyVersion`：執行階段載入依賴，**強名稱組件**必須匹配。
• `AssemblyFileVersion`：給部署/檔案系統識別用，可頻繁變更。
• 建議：Major.Minor 由架構師控制，Build 對應 CI 建置編號，Revision 對應修訂/熱修複。

2. 為組件簽署強名稱

強名稱 = 簡單名稱 + 版本 + 文化特性 + 公開金鑰Token + 數位簽章。優勢：

• 全域組件快取 (GAC) 部署。
• 防止組件被竄改/偽造。
• 解決「DLL Hell」版本衝突。

產生金鑰檔：`sn -k MyCompany.snk` → 專案屬性 → 簽署 → 選擇金鑰檔。遲簽 (Delay Sign) 適用建置伺服器環境。

3. 釋放非受控資源：實作 IDisposable 模式

public class ResourceHolder : IDisposable
{
    private IntPtr _handle;
    private bool _disposed;

    ~ResourceHolder() => Dispose(false);

    public void Dispose()
    {
        Dispose(true);
        GC.SuppressFinalize(this);
    }

    protected virtual void Dispose(bool disposing)
    {
        if (_disposed) return;
        if (disposing) { /* 釋放受控資源 */ }
        ReleaseUnmanaged(); // 釋放非受控
        _disposed = true;
    }
}

4. 使用 using 區塊確保釋放

所有實作 `IDisposable` 的物件 (`SqlConnection`、`FileStream`、`Graphics`、`Bitmap`、`HttpClient` 等) **務必包在 `using` 中**，即使發生例外也能正確釋放。

5. 避免在迴圈中字串串接，使用 StringBuilder

// 差
string s = "";
for (int i=0; i<1000; i++) s += i.ToString();

// 好
var sb = new StringBuilder(1000 * 4);
for (int i=0; i<1000; i++) sb.Append(i);
string result = sb.ToString();

6. 資料庫連線：開啟晚、關閉早、連線池

• `using (var conn = new SqlConnection(cs)) { conn.Open(); ... }` 區塊內完成操作。
• 連線字串保持 `Pooling=true` (預設)，避免頻繁建立實體連線。
• 長時間操作拆分為多個短連線，而非單一長連線。

7. 例外處理：捕獲具體例外、記錄完整堆疊、不吞沒

try { ... }
catch (SqlException ex) when (ex.Number == 1205) { /* 處理死結 */ }
catch (Exception ex) { Logger.Error(ex, "操作失敗"); throw; } // 重拋保留堆疊

8. 部署前驗證：Release 建置、預編譯、移除偵錯資訊

• `web.config`：``
• 預編譯：`aspnet_compiler -v / -p "SourcePath" -f "TargetPath"` 或 Visual Studio 「發布」→「預編譯」。
• 移除 `.pdb`、`.xml` 文件檔、Trace/Debug 輸出。

總結

這八大實踐涵蓋版本管理、組件安全、資源釋放、效能優化、資料庫存取、錯誤處理與部署品質。貫徹執行能顯著提升 ASP.NET 應用程式的穩定性、可維護性與生產環境表現。建議納入團隊編碼規範與 Code Review 檢核清單。