<!-- 這是單行註解 -->
<!--
這是多行註解
可以跨越多行
瀏覽器會完全忽略這裡的內容
-->
<!---->-- (兩個連字號) 外可包含任意字元。**註解內不能出現連續兩個連字號**,否則會提前結束或導致解析錯誤。<!-- 外層 <!-- 內層 --> 外層 --> 會在內層結束標記處結束,外層剩餘內容會被當作文字顯示。**現代瀏覽器 (IE10+, Edge, Chrome, Firefox, Safari) 忽略條件註解,視為普通註解。** 僅用於維護極舊版 IE 專案。
<!--[if IE]>
<link rel="stylesheet" href="ie-fix.css">
<![endif]-->
<!--[if gt IE 8]><!--> <!-- 非 IE 或 IE>8 可見 -->
<link rel="stylesheet" href="modern.css">
<!--<![endif]-->
<!--[if !IE]>> <!-- 非 IE 可見 (IE 視為註解) -->
<script src="modern.js"></script>
<!--<![endif]-->
語法:<!--[if 條件]> HTML 內容 <![endif]-->。條件關鍵字:IE, lt (小於), lte (小於等於), gt (大於), gte (大於等於), ! (非), & (且), | (或), () (分組)。
| 語言/情境 | 單行註解 | 多行註解 | 備註 |
|---|---|---|---|
| HTML | 無 | <!-- 註解 --> | 唯一標準語法 |
| CSS | 無 | /* 註解 */ | 可巢狀 (CSS 原生不支援,但預處理器 Sass/Less 支援) |
| JavaScript | // 註解 | /* 註解 */ | JSX/TSX 同 JS |
| TypeScript | // | /* */ | 支援 JSDoc /** */ |
| PHP | //, # | /* */ | HTML 中 PHP 區塊用 PHP 註解 |
| Python | # | """ 多行字串常用作註解 """ | 無原生多行註解 |
| SQL | -- | /* */ | |
| Shell/Bash | # | : ' 多行註解 ' (技巧) | |
| VBScript / ASP | ' 註解 | 無 | 舊版 ASP 伺服器端腳本 |
| JSON | **不支援註解** | **不支援** | 嚴格禁止,JSONC/JSON5 支援 |
<!-- 差:設定容器寬度 -->
<div style="width: 960px;">
<!-- 好:配合 960px 格線系統,確保主流螢幕無捲軸 -->
<div class="container">
<!-- ===== Header 區塊 開始 ===== -->
<header>...</header>
<!-- ===== Header 區塊 結束 ===== -->
<!-- TODO: 待替換為 API 動態資料 -->
<!-- FIXME: IE11 flexbox bug 暫時用 float 方案 -->
<!-- HACK: 修正 Safari flex 最小寬度 bug -->
<!-- 現代做法:JS 特性偵測 / 動態 import / CSS @supports -->
<script>
if (!('IntersectionObserver' in window)) {
import('./polyfill-intersection-observer.js');
}
</script>
<!--! ... --> 或 /*! ... */)。| 錯誤寫法 | 問題 | 正確寫法 |
|---|---|---|
<!-- --> (空註解) | 合法但無意義 | 移除或加入說明 |
<!-- -- --> | 內含 -- 導致解析錯誤 | <!-- 避免連續連字號 --> |
<!-- <div> --> --> | 巢狀註解,外層提前結束 | 拆分為兩個獨立註解 |
<!--[if IE]>...<![endif]--> | 用於非 IE 環境 | 移除,改用特性偵測 |
| 註解包含敏感資訊 (API Key, 內部路徑) | 前端原始碼公開可見 | **絕對禁止**,建置流程檢查 |
在 <title>, <style>, <script> 內使用 HTML 註解 | 內容被當作文字/腳本一部分,不生效 | CSS 用 /* */,JS 用 ////* */ |
document.querySelectorAll('*') 檢查節點。HTML 註解雖簡單,但**正確語法、良好習慣、區分語言差異、避免敏感資訊洩漏、建置移除**是專業開發者的基本素養。條件註解已成歷史,現代專案請改用特性偵測、漸進增強、建置時注入環境變數等標準方案。