使用說明

XML 檢查與驗證器

貼上 XML,就能用這個 XML 驗證器檢查文件格式是否正確。有錯誤時,會用簡單的話告訴你第一個錯誤所在的行與欄。加上 XSD 結構描述,還能一併檢查結構,格式正確的文件也會以整理好的樣子回傳。所有處理都在你的瀏覽器內進行,所以你的 XML 不會上傳。


線上 XML 檢查的使用步驟

  1. 按下貼上 XML,把剪貼簿內容讀進XML欄位,或自己貼上文字。貼上後會立刻檢查文件。
  2. 修改文字後,按下驗證就能再檢查一次。
  3. 在按鈕下方查看結果。綠色的有效的 XML方塊代表文件格式正確。紅色的XML 格式不正確方塊會顯示一個錯誤。
  4. 出現錯誤時,方塊會顯示行與欄、該行的片段(欄位下方有箭頭標示),以及在編輯器中顯示按鈕。編輯器也會捲動到那一行。
  5. 先修正第一個錯誤,再檢查一次。刻意只顯示第一個錯誤,因為後面的錯誤通常是它造成的連鎖反應,例如少了結束標籤。

輸入方式只有貼上,沒有檔案選擇功能。請用任何文字編輯器開啟檔案,複製全部內容,再貼進欄位。

XML 格式檢查:什麼是格式正確的 XML

第一階段只檢查語法。文件遵守下列規則,就是格式正確:

格式正確不等於有效。有效是指文件還符合某個結構描述,下方的 XSD 選項就是為此而設。

常見的 XML 錯誤與修正方法

每個錯誤都用一句話說明,而不是顯示解析器的原始訊息。以下是最常碰到的幾種:

XML 禁止的字元(例如零散的控制字元)、沒有結束的開始標籤,以及沒有關閉的註解,也都會回報。

用 XSD 結構描述驗證 XML

格式正確的文件,仍可能不符合用途:該放數字的地方是文字、缺少必要元素,或元素放錯位置。結構描述會說明哪些內容是允許的,這個工具可以拿它來核對。

  1. 按下齒輪按鈕,也就是進階選項。
  2. 把結構描述貼進XSD 結構描述(選填)。如果只想檢查格式是否正確,就留空。
  3. 把 XML 貼進XML欄位,然後按下驗證。

如果 XML 不符合,結果的標題是「不符合結構描述」並附上錯誤數量,最多列出 100 個。每一項都會給出元素的 XPath,例如 /note/n[1],屬性則是 /note/@id,接著是一句清楚的說明和所在的行。說明涵蓋:

如果問題出在結構描述而不是你的 XML,會顯示獨立的方塊:XSD 結構描述不是格式正確的 XML或無法使用這份 XSD 結構描述,而且不會用它來檢查 XML。會匯入或包含其他檔案的結構描述無法使用,因為不會抓取任何內容。請把所有定義放進同一份 XSD。支援 XSD 1.0。

XML 排版與格式化

文件有效時,結果上方會出現附有複製按鈕的已格式化的 XML區塊。在進階選項的縮排中選擇寬度:2 個空格、4 個空格或 Tab 字元。變更後結果會立即更新。格式化遵循 xmllint --format,所以結果容易預期:

輸出很長時會截斷顯示,並註明目前顯示了幾行。複製永遠會取得整份文件。

大型 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 結構描述也是一樣。