XML 註解的用法和 HTML 幾乎一樣,用來在原始碼中補充說明,或是暫時把某段標記「停用」而不真的刪除。註解只存在於原始碼裡,不會出現在解析後的資料中。
註解以 <!-- 開始,以 --> 結束:
<!-- catalog last updated 2016-02-14 -->
註解能出現在文件序言(包含 DTD 區段)、文件尾端,以及元素內容之間。但以下兩個位置是禁止的:
<?xml version="1.0" encoding="UTF-8"?>
<!-- 學生成績按月上傳 -->
<class_list>
<student>
<name>Tanmay</name>
<grade>A</grade>
</student>
</class_list>
解析器碰到 > 時就會判定註解結束,接著回到正常的 XML 處理流程。因此字串 > 不能出現在註解內容中。除了這項限制,其他合法的 XML 字元都可以放進註解,這點和 CDATA 區段相當類似。
正因為註解能從解析輸出中被完整剝除,又不影響文件本身的內容,它常被拿來臨時註標掉一段程式碼或設定。
在 HTML 裡,我們常把 <script> 或樣式表包在註解中,藉此讓老舊瀏覽器跳過它們。想在 XML 中複製這套做法,你必須先把註解內容取出來、檢查是否含有標記字元,再重新解析一遍,非常綁手。這種情境下,CDATA 區段才是更合適的選擇。