VS2019+ASP.NET中注释代码仍被编译引发重复ID报错

核心原因 #

HTML注释<!-- -->仅对客户端生效，ASP.NET服务器会解析注释内带runat="server"的服务器控件，因此即使注释了旧代码里的<asp:Label>，仍会被编译，导致ID重复报错。

可行解决方案 #

• 使用ASP.NET服务器端注释
  替换HTML注释为ASP.NET专属的服务器端注释<%-- --%>，服务器会直接忽略注释内的所有内容，不会编译其中的控件。修改后的示例代码：

  <div class="col-16">
     <asp:Label ID="myLabel" runat="server" Text="example text"></asp:Label>
  </div>
  
  <%-- OLD CODE
  <td class="auto-style6">
     <b>
        <asp:Label ID="myLabel" runat="server" Text="example text"></asp:Label>
     </b>
  </td>
  --%>
  

• 重命名旧控件ID
  手动修改旧代码里的Label ID，比如改为myLabel_old，避免与新代码ID冲突，同时保留旧代码：

  <div class="col-16">
     <asp:Label ID="myLabel" runat="server" Text="example text"></asp:Label>
  </div>
  
  <!-- OLD CODE
  <td class="auto-style6">
     <b>
        <asp:Label ID="myLabel_old" runat="server" Text="example text"></asp:Label>
     </b>
  </td>
  -->
  

• 迁移旧代码到备份文件
  新建一个备份文件（如OldPageCodeBackup.txt或OldControls.ascx），将旧代码复制到该文件中，原页面删除旧代码。既保留了历史代码，又不影响当前页面编译。

编辑器注释快捷键修复 #

在Visual Studio 2019的ASP.NET页面中，选中服务器控件代码后，使用快捷键Ctrl+K, Ctrl+C可自动添加服务器端注释<%-- --%>，无需手动输入；取消注释用Ctrl+K, Ctrl+U。

内容的提问来源于stack exchange，提问作者LordFarquaad