Sublime Text 本身不带 CSS 校验能力，必须通过 SublimeLinter 框架 + SublimeLinter-csslint 插件 + 全局安装的 csslint CLI 三者协同才能生效；漏一不可，且需正确配置 executable_map 路径、启用 linters、确保 lint_mode 为 background 或 save-only，并验证 csslint 命令可被 Sublime 直接调用。
Sublime Text 本身不带 CSS 校验能力，CSSLint 必须通过 SublimeLinter 框架 + SublimeLinter-csslint 插件 + 全局安装的 csslint CLI 才能生效。漏掉任一环节，状态栏不会显示错误，保存也无提示。
为什么装了插件却没反应？
最常见原因是 csslint 命令根本没被 Sublime 找到——它不是插件自带的，必须手动安装到系统 PATH 里。
- 在终端/命令行运行
csslint --version，如果报错'csslint' is not recognized（Windows）或command not found（macOS/Linux），说明没装或没进 PATH - 正确安装方式是：
npm install -g csslint（注意：不是--save-dev，必须全局） - Windows 用户若用 nvm 或非默认 Node 安装路径，
npm global bin返回的路径可能不在系统环境变量中，需手动添加 - Sublime 不读取 shell 的
PATH，所以即使终端能跑csslint，Sublime 仍可能找不到——此时得在插件设置里硬编码可执行路径
如何配置 SublimeLinter 找到 csslint？
打开 Preferences → Package Settings → SublimeLinter → Settings – User，填入以下关键项：
{
"sublimelinter_executable_map": {
"css": "C:\Users\xxx\AppData\Roaming\npm\csslint.cmd"
},
"linters": {
"csslint": {
"@disable": false,
"args": []
}
}
}
-
css键对应 .css 文件类型；如果是 .scss，需确认语法识别为CSS（推荐装SCSS插件并设文件关联） - Windows 路径用双反斜杠或正斜杠，且必须指向
csslint.cmd（不是.js文件）；macOS/Linux 用/usr/local/bin/csslint或npm config get prefix查路径 -
"@disable": false必须显式设为false，否则插件默认禁用 - 不要删掉
"linters"外层结构，否则整个 linter 配置失效
保存时才检查，而不是实时高亮？
默认是实时 lint，但很多人误关了或设错模式。检查 Settings – User 中是否有这行：
立即学习“前端免费学习笔记（深入）”；
"lint_mode": "save-only"
- 删掉这行，或改成
"lint_mode": "background"，才能边写边标红 - 如果只想要保存时触发（减少 CPU 占用），保留
"save-only"即可，但要确保文件保存后状态栏右下角出现CSSLint提示 - 若保存后仍无反应，先关掉其他 linter（如
jshint），排除冲突；再看 Sublime 控制台（Ctrl+`）有无csslint: command not found类报错
真正卡住的地方往往不是插件装没装，而是 csslint 这个命令能不能被 Sublime 进程直接调用——它和你终端里能跑是两回事。路径写错、权限不足、Node 版本太老（csslint 最后更新是 2021 年，不支持 Node 20+），都可能导致静默失败。
