Sublime Text 本身不支持一键美化 CSS,必须安装插件;CSSFormat 及多数带“Beautify”名称的老插件已停止维护,不兼容 Sublime Text 4,无法解析现代 CSS 语法(如 ::before、--custom-property、clamp()),易导致格式错乱、删行、崩缩进或破坏 calc() 中空格。

Sublime Text 本身不支持一键美化 CSS,必须装插件;但“CSSFormat”不是推荐选项——它早已停止维护,且不兼容 Sublime Text 4,容易导致格式错乱或插件失效。
为什么别装 CSSFormat 或名字带 “Beautify” 的老插件
这些插件多数最后更新在 2018–2020 年间,解析不了 ::before、--custom-property、clamp() 等现代 CSS 语法,一格式化就删行或崩缩进。更麻烦的是:它们常把 calc(100% - 2rem) 里的空格吃掉,变成 calc(100%-2rem),浏览器可能拒识。
- 查插件状态最简单的方法:Package Control →
Upgrade Package→ 搜插件名,如果列表里压根不出现,说明已被弃用 - 已安装的,打开 Preferences → Package Settings,若点进去是空白页或报错,基本可判定失效
- 这类插件通常没提供配置入口,出问题只能卸载,没法调参数救
真正能用的两个插件:HTML-CSS-JS Prettify vs CSScomb
选哪个,取决于你是否需要深度控制规则:
-
HTML-CSS-JS Prettify:轻量、零依赖、开箱即用。适合个人项目或快速调整,但属性顺序只能关/开("sort_properties": false),不能自定义display必须在z-index前这种逻辑 -
CSScomb:专为 CSS 设计,支持.csscomb.json配置文件,能精确控制空格、分号、括号位置、属性分组等。适合团队或已有样式规范的项目 - 两者都不支持对
.module.css或含${}的字符串做安全格式化——遇到就手动跳过
快捷键按了没反应?先检查这三件事
不是插件坏了,大概率是环境卡在某个环节:
立即学习“前端免费学习笔记(深入)”;
- 右下角语法模式必须是
CSS,不是Plain Text或SCSS(哪怕文件后缀是.css,也得手动点一下切换) -
HTML-CSS-JS Prettify默认无快捷键,必须自己加:{"keys": ["ctrl+alt+f"], "command": "html_css_js_prettify"},漏方括号或逗号会导致整个键位文件 JSON 失效,Sublime 启动变慢 -
CSScomb首次运行会自动生成.csscomb.json到项目根目录,如果没生成,说明没在项目文件夹里打开 CSS 文件(比如直接双击桌面文件),此时它不工作
格式化后属性顺序乱、缩进错、伪类消失?配错配置项了
默认配置不是为你项目写的,必须手动覆盖:
- 缩进用 2 空格:
"indent_size": 2(别只改default配置,要改User配置或项目级.csscomb.json) - 保留手写顺序:
"sort_properties": false(设为true会按 ASCII 排,z-index就真跑到width前面) - 支持双冒号和自定义属性:确认插件是最新版(Package Control →
Upgrade Package→HTML-CSS-JS Prettify),旧版解析器不认识::marker或--text-color
最常被忽略的一点:插件读取配置是有优先级的——项目根目录的 .csscomb.json 或 .prettierrc 永远高于全局设置,改来改去没生效,八成是改错了文件。


















