装错插件是格式化失败的第一原因，因Sublime Text依赖插件实现美化功能，而插件生态混乱、命名相似但功能差异大，如已停更的CSSFormat在ST4上失效，XML Formatter可能错误闭合标签，CodeFormatter与HTML-CSS-JS Prettify快捷键冲突；唯一稳妥路径是通过Package Control安装官方验证包如Pretty JSON、XML Tools、HTML-CSS-JS Prettify。
装错插件是格式化失败的第一原因
Sublime Text 本身不提供任何代码美化能力，所有“一键”操作都依赖插件。但插件生态混乱，名字相似的包功能差异极大，装错就等于白忙活。
- 别搜“CSSFormat”——它已停止维护，2024 年后在 Sublime Text 4 上基本不可用，
calc()、--custom-property、::before全被误删 - 别装“XML Formatter”或“Pretty XML”——多数只是加换行，不解析结构，可能把
<tag/>错闭成<tag></tag> - 别同时装
CodeFormatter和HTML-CSS-JS Prettify——它们默认都抢Ctrl+Alt+F，命令名分别是code_formatter和html_css_js_prettify，冲突后谁也按不动 - 唯一稳妥路径：通过
Package Control: Install Package安装官方验证过的包，如Pretty JSON（作者 dhg）、XML Tools、HTML-CSS-JS Prettify
快捷键没反应？先看右下角和光标位置
不是快捷键坏了，是触发条件没满足。Sublime 的格式化插件高度依赖上下文，缺一不可。
- 右下角状态栏必须显示对应语法：CSS 文件要显示
CSS，不是Plain text或HTML；点它手动切换一次最保险 - 光标不能落在字符串内部：比如在
"name": "hello|world"的竖线处，Pretty JSON会直接报Invalid JSON: Expecting property name enclosed in double quotes - XML 文件必须是无 BOM 的 UTF-8：菜单
File → Reopen with Encoding → UTF-8，再Save with Encoding → UTF-8，带 BOM 的文件会卡在UnicodeDecodeError - 大文件（>2MB）别硬刚：XML Tools 一次性加载 DOM，卡死是常态；JSON 超过几万行建议截段处理，或改用
python -m json.tool命令行
格式化后结构异常？别怪插件，是配置或标准限制
很多“问题”其实是设计使然，强行修改配置反而破坏稳定性。
-
Pretty JSON字段顺序乱了？这不是 bug —— JSON 规范不保证对象 key 顺序，Pythonjson.dumps()默认也不排序；想字母序排 key，得用python -m json.tool --sort-keys或装JSON Reindent插件 - XML 注释偏移、
被展开？XML Tools没提供开关，这是内置行为，无法关闭；依赖这些结构的，格式化前务必备份原始段落 - CSS 变量或嵌套失效？说明你还在用老插件；
HTML-CSS-JS Prettify需配合 Node.js 运行，且用户配置里"css_beautify_options"要设"preserve_newlines": true才能保 calc() 换行安全 - 缩进错乱？检查
Preferences → Package Settings → XMLTools → Settings – User，只改"indentation_size"（数字，非字符串）和"preserve_whitespace"（设false才重排空行）
真正的一键，靠的是组合配置而非单点点击
所谓“一键”，本质是语法识别 + 插件加载 + 快捷键绑定 + 用户配置四者对齐。漏掉任意一环，Ctrl+Alt+F 就只是个普通按键。
-
HTML-CSS-JS Prettify安装后默认不绑快捷键，必须手动进Preferences → Key Bindings – User加：{"keys": ["ctrl+alt+f"], "command": "html_css_js_prettify"} -
XML Tools装完要执行Package Control: Satisfy Dependencies（尤其 Linux/macOS），否则命令面板搜不到XML Tools: Pretty Print (XML) - 中文变问号？不是编码问题，是插件底层用了 Python 2 风格的 decode；解决办法：确保系统 Python 是 3.8+，并在插件设置里加
"ensure_ascii": false - 保存时自动格式化？
CodeFormatter支持，但HTML-CSS-JS Prettify不支持——它没有钩子机制，强行加会导致保存卡顿或丢内容
复杂点从来不在“怎么装”，而在“装完之后是否让每个环节都咬合到位”。一个没生效的快捷键，背后可能是语法识别失败、编码隐性污染、或两个插件在后台静默打架。动手前，先确认右下角、光标位置、配置项值——这三处比插件本身更常出问题。
