HTML 註解符號是 `<!-- -->`,但許多初學者容易與 CSS、JavaScript 註解混淆,或誤以為 `//`、`/* */` 也能在 HTML 中使用。本文釐清各語言註解符號差異,避免語法錯誤導致頁面異常。
<!-- 註解內容 -->
| 錯誤寫法 | 問題 | 正確做法 |
|---|---|---|
// 註解 | 屬於 JS/CSS 單行註解,HTML 中會被當作文字顯示 | 改用 `<!-- 註解 -->` |
/* 註解 */ | 屬於 CSS/JS 多行註解,HTML 中會被當作文字顯示 | 改用 `<!-- 註解 -->` |
<!--- 註解 --> | 連字號過多(三個),雖然瀏覽器容錯,但不符合標準 | 固定兩個連字號 |
<!-- 註解 ---> | 結束連字號過多 | 固定兩個連字號 |
<!-- 註解 --> --> | 多餘結束標記會顯示在畫面 | 移除多餘部分 |
| 語言/情境 | 單行 | 多行 | 適用位置 |
|---|---|---|---|
| HTML | <!-- 註解 --> | .html, .htm, 模板檔 | |
| CSS | /* 註解 */ | .css, <style> 區塊 | |
| JavaScript | // 註解 | /* 註解 */ | .js, <script> 區塊 |
| PHP | // 或 # | /* 註解 */ | .php |
| Python | # 註解 | """ 多行字串作註解 """ | .py |
| SQL | -- 註解 | /* 註解 */ | .sql |
<style>` 區塊內請用 CSS 註解;在 `<script>` 區塊內請用 JS 註解。{# #}`),編譯後不會輸出到 HTML,比 HTML 註解更安全。記住:HTML 只有 `<!-- -->` 一種註解語法,其他符號皆屬不同語言,切勿混用。