XML 檢查與驗證器
貼上 XML,就能用這個 XML 驗證器檢查文件格式是否正確。有錯誤時,會用簡單的話告訴你第一個錯誤所在的行與欄。加上 XSD 結構描述,還能一併檢查結構,格式正確的文件也會以整理好的樣子回傳。所有處理都在你的瀏覽器內進行,所以你的 XML 不會上傳。
線上 XML 檢查的使用步驟
- 按下貼上 XML,把剪貼簿內容讀進XML欄位,或自己貼上文字。貼上後會立刻檢查文件。
- 修改文字後,按下驗證就能再檢查一次。
- 在按鈕下方查看結果。綠色的有效的 XML方塊代表文件格式正確。紅色的XML 格式不正確方塊會顯示一個錯誤。
- 出現錯誤時,方塊會顯示行與欄、該行的片段(欄位下方有箭頭標示),以及在編輯器中顯示按鈕。編輯器也會捲動到那一行。
- 先修正第一個錯誤,再檢查一次。刻意只顯示第一個錯誤,因為後面的錯誤通常是它造成的連鎖反應,例如少了結束標籤。
輸入方式只有貼上,沒有檔案選擇功能。請用任何文字編輯器開啟檔案,複製全部內容,再貼進欄位。
XML 格式檢查:什麼是格式正確的 XML
第一階段只檢查語法。文件遵守下列規則,就是格式正確:
- 只有一個根元素,其他所有內容都包含在裡面。
- 每個開始標籤都有對應的結束標籤,順序正確,或像
<br/>一樣自行結束。 - 屬性值要放在引號內,例如
id="7",而且同一個標籤中的屬性只能出現一次。 - 文字中單純的 & 或 < 要寫成
&或<。 - 註解中不能連續出現兩個連字號,CDATA 區段要以
]]>結尾。 xs:這類命名空間前置詞,要在該標籤或上層標籤用xmlns:xs="..."宣告。
格式正確不等於有效。有效是指文件還符合某個結構描述,下方的 XSD 選項就是為此而設。
常見的 XML 錯誤與修正方法
每個錯誤都用一句話說明,而不是顯示解析器的原始訊息。以下是最常碰到的幾種:
- 結束標籤與開始標籤不相符:缺少結束標籤、拼錯,或順序不對。請依照開啟的相反順序關閉標籤。
- 文件在標籤關閉之前就結束了:缺少最後的結束標籤,或貼上的內容被截斷。請補上缺少的結束標籤,或貼上完整文件。
- 根元素之後還有多餘內容:多了第二個根元素,或根元素後面有文字。請把所有內容包進同一個上層元素。
- 實體尚未定義:通常是
這類 HTML 實體,或單獨的 &。請改用 ,或寫成&。 - 屬性值必須放在引號內:寫成
id=7而不是id="7"。請加上引號。 - 同一個標籤中屬性出現兩次:請刪掉其中一個。
- 用了前置詞卻從未宣告:缺少
xmlns:前置詞。請在該標籤或上層標籤加上宣告。 <?xml ...?>宣告只能放在最開頭:前面有空白行、空格或註解。請刪掉前面的內容。- 註解中連續出現兩個連字號:請改寫註解。
- CDATA 區段沒有結束:缺少
]]>。請補上。
XML 禁止的字元(例如零散的控制字元)、沒有結束的開始標籤,以及沒有關閉的註解,也都會回報。
用 XSD 結構描述驗證 XML
格式正確的文件,仍可能不符合用途:該放數字的地方是文字、缺少必要元素,或元素放錯位置。結構描述會說明哪些內容是允許的,這個工具可以拿它來核對。
- 按下齒輪按鈕,也就是進階選項。
- 把結構描述貼進XSD 結構描述(選填)。如果只想檢查格式是否正確,就留空。
- 把 XML 貼進XML欄位,然後按下驗證。
如果 XML 不符合,結果的標題是「不符合結構描述」並附上錯誤數量,最多列出 100 個。每一項都會給出元素的 XPath,例如 /note/n[1],屬性則是 /note/@id,接著是一句清楚的說明和所在的行。說明涵蓋:
- 值的型別錯誤,例如該是
xs:int的地方卻是文字; - 值違反限制:模式、列舉、長度、最小值或最大值;
- 缺少必要的子元素,或此處不該出現的元素;
- 不允許的屬性,或缺少必要的屬性;
- 結構描述沒有宣告的根元素。
如果問題出在結構描述而不是你的 XML,會顯示獨立的方塊:XSD 結構描述不是格式正確的 XML或無法使用這份 XSD 結構描述,而且不會用它來檢查 XML。會匯入或包含其他檔案的結構描述無法使用,因為不會抓取任何內容。請把所有定義放進同一份 XSD。支援 XSD 1.0。
XML 排版與格式化
文件有效時,結果上方會出現附有複製按鈕的已格式化的 XML區塊。在進階選項的縮排中選擇寬度:2 個空格、4 個空格或 Tab 字元。變更後結果會立即更新。格式化遵循 xmllint --format,所以結果容易預期:
- 縮排會從頭重新套用,標籤之間只有空白的文字會被移除。
- 元素內的文字會保持你寫的樣子。在像
<p><b>a</b> <i>b</i></p>這樣的混合內容中,標籤之間的空格可能會消失。 - 註解、CDATA 區段和 DOCTYPE 都會保留。
- XML 宣告會維持你寫的樣子,如果原本沒有,也不會自動加上。
輸出很長時會截斷顯示,並註明目前顯示了幾行。複製永遠會取得整份文件。
大型 XML 檔案與不檢查的項目
檢查是在背景的 Web Worker 中執行。非常大的文件之所以慢,主要是因為瀏覽器得把那麼多文字畫在欄位裡:測試中,一份 50 MB、超過 60 萬行的文件,從貼上到出現結果約 30 秒,20 MB 的約 11 秒。上限是 1 億 2 千萬個字元,超過時會請你改貼較小的片段。
不檢查的項目:沒有 DTD 驗證,外部實體與外部檔案也不會載入,因為不會抓取任何內容。只支援 XSD 1.0。宣告的編碼,例如 ISO-8859-1 或 UTF-16,會被忽略,因為貼上的文字本來就是 Unicode。定義了會展開成過多文字的實體的文件會被拒絕,標籤巢狀超過 2048 層也一樣。
常見問題
要怎麼檢查 XML 的格式是否正確?
把 XML 貼進「XML」欄位,然後按下「驗證」。綠色的「有效的 XML」方塊代表每個標籤都已關閉且巢狀正確,而且文件只有一個根元素。紅色的「XML 格式不正確」方塊會用簡單的話指出第一個錯誤,並附上行與欄。
什麼是格式正確的 XML?
就是遵守語法規則的 XML:只有一個根元素、每個開始標籤都以順序正確的結束標籤關閉、屬性值放在引號內、同一個標籤中沒有重複的屬性,而且像 & 這樣的特殊字元寫成 &。只要違反其中任何一條,解析器就會拒絕該文件。
格式正確的 XML 和有效的 XML 差在哪裡?
格式正確是指語法沒問題。嚴格來說的有效,還要求文件符合結構描述(XSD 或 DTD),由它規定允許哪些元素和值。在這個工具中,XSD 欄位留空時,「有效的 XML」只代表格式正確;貼上 XSD 後,則代表格式正確且符合結構描述。不支援 DTD 驗證。
XML 的「opening and ending tag mismatch」是什麼意思?
結束標籤與當下開啟中的標籤不相符,也就是缺少結束標籤、拼錯了,或兩個標籤互相交疊。這個工具會這樣說:結束標籤 與第 1 行的開始標籤 不相符。請先修正它指出的第一個錯誤再重新檢查,因為後面的錯誤通常是它造成的連鎖反應。
為什麼 XML 會顯示「extra content at the end of the document」?
根元素結束之後還有東西,最常見的是第二個根元素,例如連續貼上兩筆資料。XML 文件只能有一個根元素。請把這些資料包進同一個上層元素,或一次只貼一筆。
為什麼 XML 說實體 nbsp 尚未定義?
是 HTML 實體。XML 本身只預先定義 <、>、&、" 和 '。不換行空格請改用字元參照 ,直接輸入該字元,或在 DTD 中宣告這個實體。沒有作為實體開頭的單獨 & 要寫成 &。
「XML declaration allowed only at the start of the document」是什麼意思?
<?xml ...?> 宣告只能放在文件的最開頭,前面不能有任何東西。通常是前面有空白行、空格或註解。把宣告前面的內容刪掉,錯誤就會消失。
檢查 XML 時,我的資料會上傳嗎?
不會。檢查是在你的裝置上的瀏覽器內進行,不會上傳或儲存任何內容。你貼上的 XSD 結構描述也是一樣。