XML 作為數據交換、配置文件、文檔標記的通用格式，其編寫質量直接影響系統互操作性。本文總結從零建立 XML 專案的完整流程：需求分析 → Schema 設計 → 範例文檔 → 驗證 → 版本發布，並詳細說明 XMLSpy 企業級工具的高效用法。
XML 專案標準化流程
- 需求澄清：確定數據結構、必選/可選欄位、資料類型、約束規則、命名空間策略、版本演進政策。
- Schema 設計 (優先於 DTD)：
- 使用 XSD (XML Schema Definition)：支援資料類型、繼承、複雜類型、命名空間、唯一性約束、可擴展性。
- 採用「俄式娃娃」或「薩拉米切片」設計風格，保持結構清晰。
- 定義
targetNamespace、elementFormDefault="qualified"、版本屬性 (如 version="1.0")。
- 範例文檔驅動開發：先寫 3-5 個典型業務場景的 XML 範例，反向驗證 Schema 完備性。
- 自動化驗證管線：CI/CD 集成
xmllint / Saxon / Jing (RelaxNG)，提交即驗證。
- 文檔化發布：生成 HTML 參考手冊 (XSDDoc、Oxygen)、發布至內部 Maven/Artifactory、語義化版本號 (SemVer)。
DTD vs XSD 選型指南
| 特性 | DTD | XSD |
|---|
| 資料類型 | 無 (僅 PCDATA/CDATA) | 內建 44 類型 + 自訂簡單/複雜類型 |
| 命名空間 | 不支援 | 原生支援 |
| 約束表達力 | 弱 (元素順序、出現次數) | 強 (模式、長度、枚舉、唯一鍵、引用完整性) |
| 擴展性 | 差 | 優 (擴展元素、替換組、重新定義) |
| 工具生態 | 老舊 | 主流 (IDE、驗證器、代碼生成器) |
| 結論：新專案**一律使用 XSD**，DTD 僅維護歷史系統。 |
|---|
XMLSpy 企業版高效用法
1. 專案管理
- File → New → Project → 加入 .xsd/.xml/.xsl/.dtd，支援邏輯/物理視圖切換。
- 專案級搜索/替換、批次驗證、生成代碼 (Java/C#/C++/VB.NET)。
2. 智能編輯
- Grid View：表格化編輯複雜結構，拖拽調整順序、複製行。
- Text View：上下文感知自動完成 (基於 XSD)、即時驗證紅線提示、XPath/XQuery 控制台。
- Schema View：圖形化設計複雜類型、繼承關係、匯入/包含關係圖。
3. 雙向生成
- XML → XSD：選擇多個代表性 XML → Tools → Generate Schema → 自動推斷類型、基數、選擇性。
- XSD → XML：右鍵 Schema → Generate Sample XML → 可選包含可選元素、重複次數、固定/預設值。
4. 驗證與除錯
- F7 / Ctrl+Shift+V：依當前關聯 Schema 驗證，錯誤列表可跳轉定位。
- 支持 XSD 1.0/1.1、RelaxNG、Schematron、DTD 多標準同時驗證。
5. 轉換與發布
- XSLT 1.0/2.0/3.0 偵錯器：斷點、變數觀察、調用堆疊、效能分析。
- 輸出：HTML/PDF/Word/Excel/JSON/程式碼/資料庫腳本。
- 生成文檔：Project → Generate Documentation → 可自訂 XSL 樣式表。
團隊協作規範建議
- Schema 檔案納入 Git，受保護分支需 PR + CI 驗證通過才能合併。
- 破壞性變更 (刪除元素、改變類型、調整基數) **必須升主版本號**，並提供遷移指南/XSLT 轉換腳本。
- 命名規範：元素/屬性
lowerCamelCase、類型 UpperCamelCase、枚舉值 UPPER_SNAKE_CASE。
- 大型 Schema 拆分：
<xs:include> 同命名空間、<xs:import> 跨命名空間，模組化管理。
