7.1 编辑与校验工具：工欲善其事

7.1 编辑与校验工具：工欲善其事

一套够用的 XML 工具链只需两层：带实时校验与大纲导航的编辑器负责"写与看"，命令行校验器负责"批量与自动化"。本节给出配置清单、各工具的上手路径，以及把校验接进持续集成的做法。（原教程的"学习资源"一节并入本节的延伸阅读建议。）

编辑器层：写与看

选型只看四项硬指标：良构实时检查（3.1 节的六条规则边写边标红）、XSD 校验与联想（挂上契约后按契约提示元素）、折叠与大纲（深层文档靠导航不靠滚动）、显示不可见字符（排查 prolog 报错的 BOM 与全角空格）。

上手路径建议以一份带错文档开始：把 3.1 节的三个训练报错文档依次打开，看编辑器分别怎么标红——比读任何说明文档都快。编辑器层的价值在反馈延迟：错误在敲下回车的一秒内现形，而不是解析失败后回溯。

命令行层：批量与自动化

命令行三件套覆盖前六章全部质检工序：

一、良构检查（第3.1节工序）
   xmllint --noout order.xml
   良构则无输出、退出码 0；有错输出行号与原因

二、XSD 契约校验（第3.4节工序）
   xmllint --noout --schema order.xsd order.xml
   order.xml validates   ← 通过时的提示

三、XSLT 转换（第5.2节工序）
   xsltproc report.xsl order.xml > report.html
   转换结果写入文件，可管道拼接
​

xmllint 与 xsltproc 出自同一开源家族（libxslt/libxml2），Linux 与 macOS 常见自带，Windows 可随工具包安装。它们值得记的不是命令本身，是三个退出码习惯：0 通过、非 0 失败——脚本可以只看退出码做闸门，这正是接进持续集成的接口。

复盘：把质检接进持续集成

背景：团队契约为 order.xsd，样例报文数十份躺在仓库里，契约改版靠人肉核对哪份样例会被影响。操作：在流水线里加一步：

for f in samples/*.xml; do
  xmllint --noout --schema order.xsd "$f" || echo "违规: $f"
done
​

结果：契约每次变更后流水线自动全量校验，违规样例的文件名即时列出，谁改的契约谁修样例。解读：这一步的本质是把第 3 章"契约前移"再前移——连样例资产也纳入契约管辖。变式：转换产物也要卡？加一行 xsltproc 生成期望文件再 diff；XPath 回归同理（把表达式与期望命中数写成对账表）。这套流水线跑顺之后还有一个隐性收益：新人接手时能从流水线日志反推契约的全部历史演进，比口口相传的"约定"可靠得多——工具链的最终价值，是把团队的工程记忆固化成可执行的资产。

⚠️ 命令行工具也有 6.1 节的安全问题：老版本 xmllint 默认跟随外部实体，处理不可信文件务必确认已装新版或显式加 --nonet 禁网。

两层工具链的分工

工具选型的三不原则

盘点至此，给工具选型立三条"不"。不为没遇到的问题上重工具：个人偶尔编辑几份配置，编辑器自带校验足够，搬专业套件反而被界面与许可证拖累。不让工具能力替代知识：编辑器标红能告诉你"这行错了"，但 3.1 节的报错解读能力、3.4 节的契约设计能力仍在人脑里——工具越智能，"知道它为什么这么判"越是区分使用者的分水岭。不用不可配置默认值赌安全：每引入一个新工具处理外来文件，先查它的实体与联网默认设置（6.1 节清单），把确认动作固定成肌肉记忆。

三条原则的共同底色是工具为人服务。这本教程通篇的例子都能在纯文本编辑器加命令行环境里完成，这个最低配置组合本身就是刻意示范：先掌握"裸机"能力，工具的加速才有意义。反过来，只会在某个图形工具里点按钮的 XML 能力，换一个环境就归零——工具箱要收的是可迁移的家伙，不是拐杖。

量级感也交代一下，避免对工具有错误期待。编辑器实时校验对几千行的文档毫无压力，但几十万行的巨型文件会让任何编辑器卡顿——那时该用的是流式校验命令而非打开文件。命令行校验单份文档是毫秒级的事，几百份样例全量校验也就几秒，接进持续集成完全无感。心里有这两个量级，就不会在"工具是不是太慢"上浪费排查时间——慢的几乎从来不是工具，是文档规模与处理方式的错配。

延伸阅读建议

按学习阶段给三条：初学阶段通读 W3C 的 XML 与命名空间推荐标准（读"术语与要点"而非全文）；进阶阶段精读 XML Schema Primer（比规范本体友好得多）；实战阶段跟一个开放格式的社区（站点地图协议、Office 开放格式、SVG 规范都是可读性很好的真契约）。选标准读的原因很简单：它们是这门语言最权威也最简洁的写法示范。

本节要点回顾

• 两层工具链：编辑器管即时反馈，命令行管批量自动化；
• 编辑器四硬指标：实时良构、XSD 校验、折叠导航、可见不可见字符；
• 命令行三件套对应 3.1、3.4、5.2 三道工序，退出码即脚本闸门；
• 契约变更自动校样例是持续集成的最低配质检流水线；
• 处理不可信文件先禁网禁实体，命令行工具同样适用。

最后补一个辨析：编辑器标红与命令行报错打架时听谁的？答案是听命令行的——不同编辑器插件内置的解析器严格度不一，有的宽容模式会漏掉编码与实体细节，而命令行工具（如 xmllint）默认按规范严格判定，且与持续集成用的是同一个判定源。养成"编辑器绿灯、提交前命令行再跑一遍"的双保险习惯，本地与 CI 的判定永远一致，"我这好好的到流水线就红"这类扯皮从根上消失。这条习惯的成本是几秒钟，收益是整个团队对同一份文档的同一份信心。

工具有了，最后一节进代码：四大语言的 XML 库怎么选、怎么配。