CSScomb 在 Sublime Text 4 中不可用，因其解析器停止维护且不兼容 Python 3.8+，导致 AttributeError 及破坏 calc() 空格、删除注释、误判现代 CSS 语法；推荐改用 HTML-CSS-JS Prettify，纯 Python 实现，兼容性好、不乱改代码。
CSScomb 在 Sublime Text 4 中已基本不可用，强行启用大概率触发 AttributeError: 'NoneType' object has no attribute 'groups'，且会破坏 calc(100% - 2px) 中的空格、吞掉 /* stylelint-disable */ 注释、误判 clamp() 或 --custom-property 为非法语法。
为什么 CSScomb 会报错并破坏现代 CSS
CSScomb 官方早已停止维护，其核心解析器不兼容 Sublime Text 4 的 Python 3.8+ 运行时，node-path 配置失效后插件尝试调用空对象的 groups() 方法——这就是那个典型报错的来源。它对现代 CSS 特性的识别停留在 2018 年前：把 ::before 当成无效伪元素删掉，把 minmax(0, 1fr) 当成函数调用错误跳过，甚至把 background: linear-gradient(...) 后的换行吃成单行导致后续属性错位。
常见现象包括：
- 格式化后
calc(100% - 2px)变成calc(100%-2px) -
/* stylelint-disable */注释被移到行首或直接消失 - 多行声明（如
@media块内）被压成一行，缩进全崩 - 安装后 Sublime 控制台持续刷出
ImportError: No module named 'csscomb'
替代方案：HTML-CSS-JS Prettify 是当前最稳的选择
它纯 Python 实现，无需 Node.js，开箱即用，对现代 CSS 兼容性好得多。关键不是“能用”，而是“不乱来”——它不会重排属性顺序（除非你显式开启 "sort_properties": true），也不会动 calc() 里的空格或注释位置。
立即学习“前端免费学习笔记（深入）”；
安装与配置要点：
- 通过
Package Control: Install Package搜索并安装HTML-CSS-JS Prettify - 右下角状态栏必须显示
CSS（不是Plain Text或SCSS），否则命令不可见 - 快捷键需手动添加：
{"keys": ["ctrl+alt+f"], "command": "html_css_js_prettify"}，放在用户 Key Bindings 右侧面板 - 若处理
.vue或.svelte中的<style>块，需先选中 CSS 内容再运行命令
如果非要保留 CSScomb，必须满足三个硬条件
这不是推荐路径，但如果你有遗留项目强依赖旧版 .csscomb.json 规则，可尝试降级适配。前提是：
- 使用 Sublime Text 3（非 4），且 Python 环境为 3.3–3.7
- Node.js 版本锁定在 v14.x（v16+ 会因 API 变更导致
groups()报错） - 项目根目录存在有效
.csscomb.json，且其中禁用所有高危项："space-before-parentheses": false、"always-semicolon": false、"remove-empty-rulesets": false
即便如此，clamp()、aspect-ratio、container 查询等新特性仍会被忽略或格式错乱——这不是配置能救的，是解析器能力天花板。
真正容易被忽略的一点：Sublime 对 CSS 文件的语法识别完全依赖右下角状态栏，哪怕文件后缀是 .css，只要没点开 “Set Syntax → CSS”，任何格式化命令都不会响应。这不是插件问题，是编辑器底层机制。
