在寫過大量 XML 相關程式、API 與工具教學之後,反而容易忽略一個基本問題:我們是否還記得如何寫出結構良好的 XML?本文回到 XML 的核心概念,重新檢視元素、屬性與處理指令的使用時機。
元素是 XML 最常見的結構,但並非所有資料都適合用元素表達。元素最適合表示具有層次結構,或未來可能發展出層次結構的資料。若某個值本質上是單一、不可分割的資訊,硬要用元素包裝,反而會讓文件冗長且難以處理。
以人名為例,名本身通常沒有內在層次,若只是要表達單一名字,使用屬性往往比建立元素更合適。若需要表達頭銜、姓氏、中間名等組合,再考慮用元素或屬性搭配表達。
屬性適合承載單值資料,例如社會保障號碼、識別碼、出生日期等。這類資料通常不需要巢狀結構,也不需要重複出現。把單值資料放進屬性,不僅讓文件更精簡,也能提升解析與存取效率。
相較於取得子元素、遍歷節點、正規化文字節點等步驟,讀取屬性通常更直接。在大量迭代或高效能場景中,這種差異可能相當明顯。
處理指令並非注釋,而是用來傳遞給 XML 處理器的資訊。例如 XSLT 樣式表關聯,就常透過處理指令表達。若把處理指令寫成注釋,或依賴特定 API 去猜測注釋內容,會讓文件偏離 XML 的標準用法。
使用正確的處理指令,能讓工具鏈更穩定,也能避免把文件語意交給脆弱的字串比對。若 API 不支援某項機制,應評估替代方案,而不是把指令藏在注釋裡。
XML 的價值在於結構清楚、語意明確、工具通用。若濫用元素、忽略屬性,或把處理指令寫成普通注釋,最後只會得到冗長、難以維護且效能不佳的文件。正確使用 XML 的基礎語法,不是為了形式,而是為了讓後續的解析、查詢與整合更可靠。