萬盛學電腦網

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

HTML 註解寫法完整指南:語法、範例與常見標籤對照表

HTML 註解是開發過程中不可或缺的文檔手段,正確的註解習慣能大幅提升代碼可維護性與團隊協作效率。本文系統整理註解語法、實戰範例,並附贈常用 HTML 標籤速查表。

註解基本語法

<!-- 這裡是註解內容,瀏覽器不會渲染顯示 -->
  • 起始標記:<!--(驚嘆號後接兩個連字號)
  • 結束標記:-->(兩個連字號後接大於號)
  • 註解內容不可包含 -- 序列,否則會導致解析提前結束。
  • 可跨越多行,適合區塊說明或暫時停用代碼片段。

實戰範例

<!-- 頁首導航區塊 START -->
<header>
  <nav>...</nav>
</header>
<!-- 頁首導航區塊 END -->

<!-- 
  待優化:以下輪播圖在行動裝置效能較差,
  後續考慮改用 IntersectionObserver 延遲載入
-->
<div class="carousel">...</div>

常用 HTML 標籤快速對照表

標籤說明是否為雙標籤
<a>錨點/超連結是
<div>區塊容器是
<span>行內容器是
<p>段落是
<br>換行否(自閉合)
<img>圖片否(自閉合)
<ul>/<ol>/<li>列表是
<table>/<tr>/<td>表格是
<form>/<input>/<button>表單元素視情況
<h1>-<h6>標題層級是
<strong>/<em>語意強調/重點是

最佳實踐建議

  • 區塊級註解採用「開始/結束」成對標記,方便摺疊與搜尋。
  • 條件式註解(IE 專用)已棄用,現代專案請改用特性偵測。
  • 生產環境建議透過建構工具(如 html-minifier)移除註解以減小體積。

養成良好的註解習慣,讓代碼自我解釋,減少溝通成本,是專業前端工程師的基本素養。

copyright © 萬盛學電腦網 all rights reserved