萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 註解最佳實務:語法、用途、條件註解與建置移除

基本語法

<!-- 這是註解,瀏覽器不會顯示 -->
<!--
  多行註解
  可跨越多行
-->
  • 不可巢狀:` 外層 -->` 會在第一個 `-->` 結束。
  • 註解內容會出現在「檢視原始碼」與開發者工具中,**不要寫入敏感資訊**(API 金鑰、內部路徑、TODO 密碼等)。

常見用途

  • 區隔區塊:`` / ``。
  • 說明複雜邏輯:``。
  • 暫時停用代碼:``。
  • 模板引擎標記:`{{!-- Handlebars 註解,不輸出到 HTML --}}`。

IE 條件註解(僅 IE5-9)

<!--[if IE]>
  <link rel="stylesheet" href="ie.css">
<![endif]-->
<!--[if gt IE 8]><!-->
  <link rel="stylesheet" href="modern.css">
<!--<![endif]-->

IE10+ 及現代瀏覽器視為普通註解忽略。現代專案改用特性偵測或 `@supports` 替代。

建置階段移除註解

  • HTMLMinifier / html-minifier-terser:`removeComments: true`。
  • Vite / Webpack / Gulp 整合壓縮外掛。
  • 保留特定註解:`removeComments: { safe: true }` 保留 `