ASP.NET 剖析器錯誤：控制項與變數命名衝突導致的大小寫不敏感問題

錯誤現象

發布至 IIS 後出現「剖析器錯誤：發現不明確的匹配」，但檔案系統偵錯正常。錯誤畫面：

觸發代碼

public partial class _Default : System.Web.UI.Page
{
    private string button1 = "test";
    protected void Page_Load(object sender, EventArgs e)
    {
        Response.Write(Button1.Text); // 控制項 ID
        Response.Write(button1);      // 區域變數
    }
}

根因分析

• ASP.NET 2.0 執行階段對控制項 ID 與變數名稱**不區分大小寫**匹配。
• Button1 (控制項) 與 button1 (變數) 在不區分大小寫下視為同一識別符，導致剖析器無法判斷引用對象。
• 開發伺服器 (Cassini) 較寬鬆，故偵錯時不發生。

最佳命名慣例

1. 控制項 ID 使用 PascalCase：BtnLogin、TxtUserName。
2. 區域變數/欄位使用 camelCase：btnLogin、userName。
3. 私有欄位加底線前綴：_btnLogin。
4. 啟用程式碼分析規則 (CA1707/CA1709) 自動偵測。

總結

命名衝突在 IIS 部署才暴露，養成嚴格大小寫區分慣例並配合靜態分析，可從源頭杜絕此類難以重現的部署期錯誤。