简介：xmlstarlet-1.6.1-win32.zip是一份面向Windows 32位系统的XML命令行工具包，适合开发、测试及运维人员快速处理XML文档。该工具以XPath为核心，支持节点查询、文档校验、增删改、格式化以及HTML/JSON等格式转换，能显著简化日常XML操作。压缩包共15个文件，除核心程序xml.exe外，还包含使用手册（txt/pdf/html）、版权与更新说明等，整体仅1.48MB，轻量便携。目前已有279人学习下载。解压后将可执行文件加入系统PATH，即可在命令行直接运行xmlstarlet命令；例如用fmt整理杂乱XML，用ed动态增删节点，还可借助XSD或Relax NG验证文档结构合规性。文档中附有完整参数说明与示例，便于快速上手，在脚本批处理或项目集成中都非常实用。这份工具包兼容Linux、macOS等多平台，是处理XML问题的可靠基础装备。
1. xmlstarlet-1.6.1-win32.zip：一个 3MB 的 zip 包，接管 Windows 上的 XML 全部杂活
拿到手的是一个xmlstarlet-1.6.1-win32.zip，解压后只有一个xmlstarlet.exe，体积不到 3MB。比起装 Python、装 PowerShell 模块，这个 exe 让我在 Windows 上处理 XML 的速度至少快了一倍：查节点、改属性、转格式、校验合法性，全部一条命令搞定。对于经常要跟配置文件、接口报文、导出数据打交道的运维和测试来说，这个 zip 包就是随身携带的 XML 瑞士军刀。这篇文章我按自己实际使用的路径来写——从解压 zip 到跑通第一条命令，再到五个高频操作和踩过的坑，最后给出一套可复用的脚本封装思路，希望你也能少走那几步冤枉路。
2. 解压 zip 到跑通第一个命令：xmlstarlet 的安装思路与最小验证
2.1 为什么选 xmlstarlet 而不是 PowerShell / Python 脚本
在 Windows 上处理 XML，常见的替代方案是 PowerShell 的[xml]类型和 Python 的xml.etree.ElementTree。PowerShell 处理简单 XML 很方便，但遇到命名空间、XPath 复杂表达式、批量文件时脚本会变得又长又绕；Python 虽然功能强，但目标机器不一定装了 Python，装了解释器还要 pip 依赖。xmlstarlet 的优势在于它是一个独立的二进制文件，不依赖任何运行时，而且 XPath 语法和 Linux 上的xmlstarlet完全一致，跨平台知识可以直接迁移。
另一个关键点是版本。1.6.1 是 XMLStarlet 项目在 1.6.0 之后的重要修复版，重点修了 Windows 上路径含空格、带命名空间文档的ed操作等问题。win32 后缀表明这是为 32 位 Windows 编译的版本，实际在 64 位 Windows 上同样能运行，因为 64 位系统自带 WOW64 兼容层。zip 压缩包的好处是不用执行 installer，不写入注册表，适合做绿色工具随拿随用。
2.2 解压 zip 的正确姿势：路径、环境变量与 win32 兼容性
下载到的 zip 包建议先校验一下大小和哈希，避免文件不完整。解压时不要直接双击打开 zip 拖出 exe，而是右键解压到指定目录。一个常见做法是放到C:\tools\xmlstarlet-1.6.1-win32下，保持目录名不包含空格和中文。虽然 1.6.1 修复了路径空格问题，但批处理脚本里引用带空格的路径还需要额外转义，没必要给自己找麻烦。
解压后把路径加进系统环境变量，这样xmlstarlet才能在任意目录下直接调用。打开“此电脑”属性 -> 高级系统设置 -> 环境变量，在系统变量Path里追加C:\tools\xmlstarlet-1.6.1-win32。注意是追加，不要覆盖原有变量。如果不想改环境变量，也可以直接使用完整路径调用，后续示例我统一用xmlstarlet命令代表它。
提示：win32 版本的 exe 在 64 位系统上没问题，但如果你的脚本里用到了 64 位 PowerShell 调用，注意系统目录
C:\Windows\System32里可能不存在这个命令，需要显式指向你的解压目录，避免 PATH 解析问题。
2.3 跑通第一个 sel 命令，验证 xmlstarlet 是否可用
先把能不能用验证掉。在 cmd 里进入一个有 XML 文件的目录，执行：
xmlstarlet sel -t -v "//book/title" books.xml这个命令用sel（select）模式，-t表示使用模板，-v是输出选中节点的值，"//book/title"是 XPath 路径，books.xml是待处理文件。如果books.xml里有两个<book>节点，每个都有<title>子节点，那么屏幕会依次输出两行书名，没有其他多余信息。
这行命令是验证安装是否成功的黄金标准：能输出说明 exe 可执行、文件被正确读取、XPath 引擎工作正常。如果这里报错，后面的所有操作都没法进行。我还习惯先查一下版本信息：
xmlstarlet --version正常会输出类似xmlstarlet 1.6.1外加 libxml2 版本。如果版本号对不上，那说明 zip 包可能不是原版，建议回到官方出品的源重新下载。千万不要从第三方下载站拿这种命令行工具，被植入后门的话你写的每条命令都有可能被劫持。
3. 五个高频操作：用 sel、ed、tr、val 覆盖日常 XML 增删改查
3.1 sel：用 XPath 查询节点，比 grep 更懂 XML
XML 最大的问题是文本形式的标签让grep和findstr无法准确匹配结构。比如要找出价格大于 30 元的书的书名，用文本搜索只能匹配到price后面的数字，但书的层级关系根本表达不了。xmlstarlet 的sel模式配合完整的 XPath 1.0 语法就能直接做谓词筛选：
xmlstarlet sel -t -m "//book[price>30]" -v "title" -n books.xml这里的-m表示匹配一组节点并循环，-v "title"是在每个匹配节点里取title子节点的值，-n是输出换行。命令的输出就是所有价格大于 30 的书名，一行一个。
如果 XML 文件里有命名空间，XPath 默认不带前缀是匹配不到节点的。比如很多接口返回的 XML 根节点带xmlns="http://example.com/ns"，这时候必须在 XPath 里用本地名称函数：
xmlstarlet sel -t -v "//*[local-name()='book']/*[local-name()='title']" books.xml这个写法无视命名空间前缀，只按标签名匹配，是处理 SOAP 报文和 RSS 源的常规操作。另外，sel还支持通过-i做条件判断，比如输出“是否在促销”标记，但日常用-m加-v已经能覆盖大多数查询需求了。
3.2 ed：原地修改 XML，解决“改一个属性”的痛点
修改 XML 文件比查询容易出错，因为要保证修改后文件仍然是合法 XML。常见场景：把配置里某个超时时间从 30 改成 60，或者给一批节点加某个属性。用文本编辑器的替换功能很难处理“路径相同但值不同”的节点，而ed模式用 XPath 定位，指哪打哪。
xmlstarlet ed --inplace -u "//config/timeout" -v "60" app.xml--inplace表示原地修改，直接改写app.xml；-u是更新节点值，后面跟 XPath，-v "60"是新值。如果节点不存在，ed会静默跳过而不会报错，所以执行前最好先用sel验证一下 XPath 能匹配到目标节点，否则你会发现改了没反应。
新增属性和子节点也很常用：
xmlstarlet ed --inplace -a "//book[title='XML入门']" -t elem -n "edition" -v "2" books.xml-a表示在匹配节点之后插入，-t elem是插入元素，-n "edition"是新元素名，-v "2"是文本值。如果要在属性上操作，-a配合-t attr即可。注意ed默认输出修改后的 XML 到标准输出，不加--inplace不会改文件，这个习惯可以避免误写。
3.3 tr：把 XML 转成 CSV / 其它格式的批处理思路
把 XML 转成 CSV 是最常见的交付需求，因为 Excel 和数据库导入都吃 CSV。xmlstarlet 的tr模式用 XML 模板文件描述转换规则，比直接用命令行参数更灵活。先写一个books.csv.xsl模板：
<?xml version="1.0"?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:output method="text" encoding="UTF-8"/> <xsl:template match="/"> <xsl:for-each select="//book"> <xsl:value-of select="title"/>,<xsl:value-of select="price"/> </xsl:for-each> </xsl:template> </xsl:stylesheet>然后执行：
xmlstarlet tr books.csv.xsl books.xml > books.csv这个模板里 是换行符的 XML 实体，method="text"告诉处理器输出纯文本而不是 XML。如果字段值本身可能包含逗号或引号，CSV 规则要求字段加引号、内部引号翻倍，模板里要专门处理，这是新手最容易翻车的地方——直接用value-of拼出来的 CSV 遇到包含逗号的标题字段就对不齐列了。
3.4 val：校验 XML 合法性，接住外部文件的格式问题
从第三方接口拿到的 XML 经常带着编码混乱、标签不闭合的问题。val模式用来做合法性校验，不输出详细解析错误的话，只给出一个判定结果：
xmlstarlet val --well-formed -e books.xml--well-formed表示只检查良构性，不加载 DTD；-e会在校验失败时输出错误信息。成功时返回码是 0，失败时返回码非 0，这个特性在批处理脚本里非常有用。比如我写自动检查脚本时，直接利用%ERRORLEVEL%判断是否继续后续流程。
比良构性更严格的校验是加载 DTD 或 Schema，但本地 DTD 文件路径经常写错，xmlstarlet 默认不联网拿外部 DTD，所以如果 XML 文件里引用了网络 DTD，val --dtd会卡住。我一般的做法是先--well-formed做快速检查，再单独验证业务规则，不要把所有责任都丢给 xmlstarlet。
3.5 用 for 循环在批处理里组合使用这几个命令
实际工作中很少只跑一条命令，而是要对整个目录的一批 XML 做统一处理。在 cmd 批处理里用for循环组合sel和ed是标准做法：
for %f in (D:\data\*.xml) do ( xmlstarlet sel -t -v "//total" "%f" >> all_total.txt xmlstarlet ed --inplace -u "//status" -v "processed" "%f" )注意批处理文件里%f要写成%%f，命令行直接执行则用单%f。每处理一个文件都要启动一次 xmlstarlet 进程，文件数量上百时速度会比较慢。如果追求性能，可以改用 xmlstarlet 的sel加--root直接处理多个文件，但那样输出会连在一起，不如循环清楚。
这里有个逻辑陷阱：循环体内两条命令都指向同一个文件，第一条读文件，第二条写文件，如果第一条命令失败，第二条的--inplace依然可能执行，把文件改成半成品。我习惯在循环里先把文件复制到临时目录，处理完再统一挪回来，或者用val先检查一遍再进循环，减少中途翻车的概率。
4. 避坑与常见问题排查：win32 下 xmlstarlet 的 5 个典型踩坑现场
4.1 现象：cmd 里执行提示“不是内部或外部命令”，但 exe 明明在
原因：环境变量没生效，或者 cmd 没有重新加载环境变量。修改Path后，已经打开的 cmd 窗口不会自动刷新，必须新开窗口；另一个原因是解压目录是带空格的路径，比如放在C:\Program Files下，系统变量中如果用双引号包裹路径，批处理解析时容易出错。
解决：新开一个 cmd 窗口，先执行echo %PATH%确认解压目录在列表里。如果路径里有空格，建议直接把整个目录放到C:\tools这类无空格路径。还要确认 zip 包解压后是否真的产出了xmlstarlet.exe，请到该目录执行dir xmlstarlet.exe看文件是否完整，文件大小约 3MB，如果只有几十 KB 说明下载文件损坏。
4.2 现象：解压 zip 时被安全软件拦，或解压后文件只有 0KB
原因：zip 包里的 exe 因为命令行工具的特性，可能触发安全软件的行为扫描，特别是当它被其它脚本调用时。文件只有 0KB 通常是解压过程中断或压缩包本身不完整，也可能是杀毒软件隔离了部分内容。
解决：从可信来源重新下载 zip，下载完成后先比对 SHA256 校验值。解压时暂时关闭实时防护，解压后把xmlstarlet.exe加入信任列表。不要用 Windows 自带“提取全部”功能，它遇到特殊权限目录会报“directory picker failed”类错误，推荐用 7-Zip 解压，对文件权限和长路径的处理更稳。
4.3 现象：XPath 匹配不到中文节点，或输出乱码
原因：XML 文件本身是 UTF-8 编码，但 cmd 窗口默认代码页可能是 GBK，导致输出到终端时显示乱码；另一种情况是文件声明了encoding="GB2312"，而 xmlstarlet 内部按 UTF-8 处理，字符长度或本地名称匹配出现偏差。
解决：输出乱码时，先执行chcp 65001切换代码页，然后重试命令。如果是处理 GBK 编码的 XML，不要用sel -v直接输出到屏幕，而是把输出重定向到文件，再用 Notepad++ 查看编码。匹配不到中文节点时，检查 XPath 表达式里的中文字符串是否与文档字节完全一致，尤其注意全角空格和半角空格的区别——这种问题肉眼很难看出来，我通常在命令行里先xmlstarlet sel -t -v "//*" file.xml把全部文本 dump 出来看编码。
4.4 现象：ed 修改后文件变成 UTF-8 BOM，其它工具不认
原因：xmlstarlet 1.6.1 在 Windows 上默认以 UTF-8 带 BOM 形式写回文件，而如果你原文件是 UTF-8 无 BOM，修改后会在文件头多出EF BB BF三个字节。某些 XML 解析器（尤其是 Java 旧版）遇到 BOM 会直接爆错。
解决：修改后不要直接用，先检查文件头部字节。可以用xmlstarlet ed输出到临时文件，然后用 PowerShell 去掉 BOM：
$content = Get-Content -Raw -Encoding UTF8 tmp.xml [System.IO.File]::WriteAllText('final.xml', $content, (New-Object System.Text.UTF8Encoding $false))更好的办法是保持原文件编码，用--copy加-O选项控制输出编码，但 1.6.1 的-O只覆盖声明不强制写回格式，所以我最终放弃让 xmlstarlet 直接改原文件，而是统一走“改临时文件再替换”的流程。
4.5 现象：32 位版在 64 位系统跑得好好的，换台机器就闪退
原因：win32 版依赖的 VC++ 运行库（msvcr100.dll 或 msvcp100.dll）在干净的系统上可能缺失，或者旧机器上存在不兼容的第三方 DLL 拦截。exe 本身是 32 位，在 64 位系统上通过 WOW64 运行，但某些精简系统把 WOW64 组件裁剪掉了。
解决：在闪退的机器上执行xmlstarlet --version，如果瞬间退出且没有任何输出，先用where xmlstarlet确认调用的不是别的目录下的同名文件。接着装上微软 Visual C++ 2010 运行库，这是 win32 版最典型的依赖。仍然闪退就把 exe 拖到事件查看器里看错误模块，一般会看到ncrypt.dll或msvcrt.dll报错，那时检查系统补丁即可。批处理脚本里加一小段防御：
if not exist "C:\tools\xmlstarlet-1.6.1-win32\xmlstarlet.exe" ( echo xmlstarlet not found, exit exit /b 1 )避免脚本跑一半才发现工具不可用。
5. 进阶用法：用 xpath 变量加模板，把 xmlstarlet 封装成可复用脚本
5.1 用 -b 和 --var 实现“传参进 XPath”
写死 XPath 不是一个好习惯，因为换一批 XML 就要改命令。xmlstarlet 的-b选项允许给根节点绑一个变量，--var可以在启动时设定变量值。假装你要统计任意 XML 文件里某个标签出现次数：
xmlstarlet sel -t --var name="'book'" -v "count(//*[local-name()=$name])" books.xml注意--var name="'book'"里的单引号表示这是一个字符串字面量。如果想通过批处理外部传入标签名，可以把变量名用双引号包起来：
set TAG=book xmlstarlet sel -t --var tag="'%TAG%'" -v "count(//*[local-name()=$tag])" books.xml这种做法的价值在于，你的脚本不再为每一个标签写死一条命令，而是把标签名当作参数。我在处理多版本接口报文时，用同一个脚本传入不同命名空间的标签名，省去了维护十几个相似命令的工作量。
5.2 用 --output-dir 批量重组 XML 文件
sel模式支持--output-dir，可以把每个匹配节点单独输出成一个文件，这非常适合把一个大 XML 拆成多个小文件。比如把一本书一个节点的书目拆出来：
xmlstarlet sel -t -m "//book" -v "." --output-dir D:\out\ book.xml这里的-v "."输出当前节点及其所有子节点的 XML 文本，--output-dir D:\out\告诉 xmlstarlet 每遇到一个匹配节点就写一个文件。文件名默认是节点在文档中的位置编号，比如1.xml、2.xml。如果想用业务字段做文件名，需要配合--root或者先ed加属性再拆，步骤略繁琐。
一个实用技巧是拆完后用--output-dir加--indent让输出格式整齐，方便人工阅读：
xmlstarlet sel -t -m "//book" -v "." --output-dir D:\out\ --indent book.xml--indent会按 2 空格缩进输出，但注意它会改变原始节点换行格式，不适合用于要做逐字节比对的文件。
5.3 验证脚本：写一个 dosed 自检，确保每次发布可用
我已经把 xmlstarlet 的常用操作封装成一个do_xml.bat，每次给到别人之前先跑一遍自检脚本，确认工具文件完整、环境变量正确、核心功能可用。一个最小自检脚本如下：
@echo off set TOOL=C:\tools\xmlstarlet-1.6.1-win32\xmlstarlet.exe set TMP_FILE=%TEMP%\xmlstarlet_selftest.xml echo ^<?xml version="1.0"?^>^<root^>^<item^>ok^</item^>^</root^> > "%TMP_FILE%" "%TOOL%" sel -t -v "//item" "%TMP_FILE%" >nul 2>&1 if errorlevel 1 ( echo [FAIL] xmlstarlet sel not available exit /b 1 ) "%TOOL%" ed --inplace -u "//item" -v "done" "%TMP_FILE%" if errorlevel 1 ( echo [FAIL] xmlstarlet ed not available exit /b 1 ) "%TOOL%" val --well-formed "%TMP_FILE%" >nul 2>&1 if errorlevel 1 ( echo [FAIL] xmlstarlet val not available exit /b 1 ) echo [PASS] xmlstarlet sel/ed/val all ok del "%TMP_FILE%"这里把sel、ed、val都验证一遍，任何一步返回非零就立刻退出。echo ^<的转义是批处理里写特殊字符的常见陷阱，如果不想处理转义，也可以改用 PowerShell 写测试文件。这个自检脚本让我在换机器、换环境时能在一分钟内确认工具可用，而不是等到脚本跑了一半才暴露问题。
我最后一个习惯是：任何时候都不要让 xmlstarlet 直接操作唯一的生产文件，哪怕你确信--inplace没问题。先把文件复制一份，改完后 diff 一下，确认没有意外的格式改动再替换回去。这个习惯帮我避免过一次把公司配置文件全改成 UTF-8 BOM 的事故，那次之后我就把“先备份再改”写进了所有脚本的注释第一行。希望这些经验能让你少踩几个坑，至少在 Windows 上处理 XML 时，能做到随手一条命令，不用再为解析器焦头烂额。
本文还有配套的精品资源，点击获取
