sublime text 中 stylelint 不生效的根本原因是 stylelint cli 未被正确调用或规则未作用于 scss 文件:需确保 node.js 环境可用、stylelint 可执行路径正确、配置文件存在且有效;scss 文件必须手动设为 scss 语法(非 plain text);scss 特有规则需配置 customsyntax: "postcss-scss" 和 plugins: ["stylelint-scss"];自动修复仅限 stylelint 14+ 且部分规则支持。

Sublime Text 本身不带 Stylelint,装了插件却没反应、保存后没提示、修复按钮点不动——根本原因不是插件没装对,而是 stylelint 命令根本没被正确调用,或者规则压根没生效到 SCSS 上。
SublimeLinter-stylelint 调用失败的三个硬性条件
插件只是“传话员”,真正干活的是你项目里或全局安装的 stylelint CLI。它启动失败,就等于整条链路断了:
- Node.js 环境必须可用:终端执行
node -v和npm -v都得有输出,否则 SublimeLinter 找不到执行环境 -
stylelint必须能被定位到:SublimeLinter 默认查node_modules/.bin/stylelint(项目内)或全局stylelint命令;如果只装了npm install -g stylelint,但系统 PATH 没包含 npm 全局 bin 目录(如 Windows 的%AppData%\npm),就会报Cannot find executable "stylelint" - 配置文件必须存在且可读:根目录下至少要有
stylelint.config.js或.stylelintrc.js,内容不能为空;空配置或语法错误会导致静默退出,连 warning 都不抛
SCSS 文件不被识别导致零报错
Sublime 默认把 .scss 当作 Plain Text,而 SublimeLinter-stylelint 只检查被标记为 CSS 或 SCSS 语法的文件。右下角显示 “Plain Text” 就是典型信号。
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
- 手动切换语法:点击右下角语言名 → 选
SCSS(注意不是Sass或PostCSS) - 确认高亮生效:变量
$color、嵌套&__item、@mixin应有颜色区分;若仍是灰字,说明语法包没装或未启用 - 推荐安装
SCSS插件(Package Control 搜 “SCSS”),避免用老旧的 “Sass” 包,后者不支持现代 SCSS 语法
max-nesting-depth 等 SCSS 规则不生效的真相
max-nesting-depth 这类规则默认只解析标准 CSS,遇到 &、@include、$var 就直接跳过——不是 bug,是设计如此。你看到“没报错”,其实是被忽略了。
- 必须显式启用 SCSS 解析器:在
stylelint.config.js中加customSyntax: "postcss-scss" - 必须加载
stylelint-scss插件:仅靠stylelint-config-sass-guidelines不够,得额外npm install --save-dev stylelint-scss - 必须声明插件:配置里写
plugins: ["stylelint-scss"],否则at-rule-no-unknown等规则对@mixin无效 - 示例最小有效片段:
module.exports = {
extends: ["stylelint-config-sass-guidelines"],
customSyntax: "postcss-scss",
plugins: ["stylelint-scss"],
rules: {
"max-nesting-depth": 3,
"scss/at-rule-no-unknown": true
}
};
保存时自动修复需满足的版本与配置门槛
--fix-on-save 不是开关一开就灵。Stylelint 14+ 才稳定支持 CSS/SCSS 自动修复,且仅限部分规则(如 indentation、color-hex-case),max-nesting-depth 这类结构性规则无法自动修。
- 在 SublimeLinter 设置中开启:
"stylelint": {"args": ["--fix-on-save"]} - 确保
stylelint是 14.0.0+ 版本:npx stylelint --version - 修复失败时检查控制台:Sublime → View → Show Console,搜索
stylelint错误,常见原因是配置文件路径不对或customSyntax加载失败 - 别依赖全局安装修复:项目内
node_modules/.bin/stylelint才会读取项目级stylelint.config.js,全局命令读的是用户主目录下的配置
最容易被忽略的是:SCSS 文件是否真被当作 SCSS 解析,而不是靠文件扩展名“猜”。哪怕配置全对,只要语法类型没切对,整个校验链就卡在第一步。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










