Notepad++需v7.6+且位数匹配才能通过Plugins Admin安装XML Tools;版本过低或位数不符会导致插件不显示,安装后必须完全退出重启;格式化失败多因XML语法错误或编码不一致,须先校验语法并统一编码。

XML Tools 插件装不上?先看 Notepad++ 版本和位数
Notepad++ v7.6 以上才能用 Plugin Admin 安装 XML Tools;低于这个版本(比如 v7.5 或更老),Plugin Admin 根本不显示该插件,强行点“安装”也没反应。打开 帮助 → 关于 Notepad++,确认两件事:vX.X.X (64-bit) 还是 (32-bit),以及主版本号是否 ≥ 7.6。
常见错误现象:插件管理器里搜不到 XML Tools、点了安装没提示、重启后菜单里没有 Plugins → XML Tools。
- 若版本过低,必须升级 Notepad++(推荐直接装
8.9.5官方 x64 安装包) - 若位数不匹配(比如 64 位 Notepad++ 放了 32 位
XMLTools.dll),插件加载失败且无任何报错,菜单直接消失 - 便携版用户注意:plugins 路径在解压目录下,不是
C:\Program Files\
用 Plugin Admin 安装 XML Tools(推荐,但有坑)
这是最省事的方式,但依赖网络和官方源可用性。2026 年部分内网或受限环境会因连接超时导致安装卡死或静默失败。
操作路径:Plugins → Plugins Admin… → 搜索框输入 XML Tools → 勾选 → 点击 Install → 等提示重启。
- 安装完成后必须重启 Notepad++,否则菜单不出现
- 如果搜索不到,先点右上角
Update刷新插件列表(旧缓存可能未同步) - 若仍失败,说明 Plugin Admin 后端不可达,改用手动安装(见下一条)
- 不要选错名字相近的插件,如
XML Syntax Highlighting或XML Validator,它们不提供格式化功能
手动安装 XML Tools(离线/企业/旧版刚需)
适用于无法联网、被墙、或使用定制版 Notepad++ 的场景。关键不是“把 DLL 往 plugins 里一扔”,而是目录结构和依赖要对。
正确做法:plugins 目录下新建文件夹 XMLTools,把下载的 XMLTools.dll(务必匹配位数)放进去;若插件包含 ext_libs 文件夹,里面的 .dll 也要复制到 Notepad++ 主目录(即和 notepad++.exe 同级)。
- 下载地址认准 GitHub Release 页面:
https://github.com/morbac/xmltools/releases,别用第三方网盘链接(签名失效或被篡改风险高) - Notepad++ 8.9.5 用户请选
XMLTools_x64.dll(或_x86),别用标着 “for v7.1” 的老版本 - 手动安装后,启动 Notepad++ 前务必关闭所有进程(任务管理器里杀干净
notepad++.exe) - 验证是否加载成功:
Plugins菜单里出现XML Tools子项,且子菜单含Pretty print和Validate now
装完不能用?十有八九是编码或内容问题
即使插件装好了、菜单也出来了,点 Pretty print 却弹窗报错 not well-formed,这不是插件问题,而是 XML 本身不合法。
XML Tools 底层调用 libxml2,它对良构性(well-formedness)要求严格:根元素唯一、标签大小写一致、属性值必须加引号、不能有未转义的 & 或 。
- 先检查编码:
编码 → Encode in UTF-8(不是 UTF-8-BOM),含中文时 BOM 会导致校验失败 - 全选内容 →
编码 → Convert to UTF-8再试格式化 - 若 XML 来自浏览器调试面板或日志粘贴,很可能混入控制字符(如
\u200b零宽空格),用视图 → 显示符号 → 显示所有字符可查出 - 校验失败时,弹窗提示的行号列号是真实位置,但有时因编码错乱偏移,建议从头逐段注释掉排查
not well-formed —— 它不告诉你哪错了,只说“你写的不是 XML”。这时候别怀疑插件,先拿一段最简 XML(比如 <root><a>1</a></root>)测试是否能格式化,再逐步还原原始内容。


















