xml tidy插件因依赖python 2和过时库,在sublime text 4(python 3.8+)中基本失效,报importerror或attributeerror;推荐用xmllint构建系统、powershell方案或prettier+prettier-plugin-xml替代。

Sublime Text 本身不带 XML 格式化功能,XML Tidy 插件已多年未维护,直接装上大概率报错或根本没反应。
为什么 XML Tidy 在新版 Sublime 上基本不能用
这个插件依赖 Python 2 的 HTMLParser 和旧版 BeautifulSoup,而 Sublime Text 4 默认用 Python 3.8+,连 xmltidy 命令行工具都早停更了。你装完插件点菜单没反应、控制台刷出 ImportError: No module named BeautifulSoup 或 AttributeError: 'str' object has no attribute 'decode'——都是典型症状。
- 它不支持 CDATA、处理注释容易错位、对命名空间(
xmlns)常丢属性 - Sublime Package Control 里搜到的同名插件,90% 是 fork 自 2013 年的老版本,没人修兼容性
- 即使硬改源码适配 Python 3,
minidom或lxml的依赖也得手动配,不如换方案
用 subl --command + xmllint 快速替代(macOS / Linux)
本地有 xmllint(libxml2 自带,macOS 用 brew install libxml2,Ubuntu 用 apt install libxml2-utils),就能绕过插件直接格式化。
- 在 Sublime 里打开 XML 文件,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Tools: Build With...,选New Build System... - 粘贴以下内容并保存为
XML Format.sublime-build:
{
"cmd": ["xmllint", "--format", "--encode", "UTF-8", "$file"],
"selector": "text.xml",
"file_regex": "^.*:([0-9]+):([0-9]+):"
}
- 保存后,按
Ctrl+B(或Cmd+B)就能原地格式化,错误会定位到行号 - 注意:
xmllint对 DTD 或 XSD 引用失败时会直接退出,不是所有 XML 都能“无脑格式化”
Windows 用户用 PowerShell + [xml] 类型强制重载
不用装第三方工具,靠系统自带 PowerShell 就能做基础缩进(不处理 DTD、不校验 schema,但够日常看)。
- 新建 Build System,内容如下:
{
"cmd": ["powershell", "-Command", "$x=[xml](Get-Content '$file' -Raw); $x.Save('$file'); Write-Host 'Formatted.'"],
"selector": "text.xml",
"encoding": "utf-8"
}
- 这个方案会抹掉注释位置、把自闭合标签(如
<tag></tag>)转成<tag></tag>,但不会崩、不报错、不依赖外部命令 - 如果 XML 里有非法字符(比如没转义的
&),[xml]解析直接抛System.Xml.XmlException,文件不变——这是保护机制,不是 bug
真正稳定可靠的方案:用 prettier + prettier-plugin-xml
如果你项目里已经用 prettier,加个插件就行,支持 VS Code 和 Sublime(通过 SublimeLinter-prettier 或 JsPrettier 调用)。
- 先全局装:
npm install -g prettier prettier-plugin-xml - 在 Sublime 安装
JsPrettier插件(它支持调任意 CLI 工具),然后配置用户设置里加:
"jsprettier": {
"auto_format_on_save": true,
"custom_file_extensions": ["xml", "xsd", "xsl"],
"additional_cli_args": {
"--parser": "xml",
"--plugin-search-dir": "/usr/local/lib/node_modules"
}
}
- 它能正确处理 CDATA、保留注释、支持 XSLT 和复杂命名空间,但要求 XML 是 well-formed 的(标签闭合、引号匹配)
- 第一次运行可能慢半秒——因为要启动 Node 进程,之后就缓存了
别在 XML Tidy 上耗时间了,它的失效不是你操作问题,是整个技术栈断代了。真正卡住你的,往往是 XML 里那个没转义的 &,或者 BOM 头导致解析失败——这些,xmllint 和 prettier 都会明确告诉你哪一行不对。










