应弃用已停止维护的 sass-lint,改用活跃维护的 stylelint;配置需手动指定 executable 路径、使用绝对路径的 json 配置文件、避免自动修复冲突,并确保 v16+ 与 v9+ 配置包支持新语法。

@use、@forward),强行配只会卡在“找不到 linter”或“解析失败”上。
要用就用 stylelint —— 它是当前唯一活跃维护、支持 SCSS/Sass/CSS-in-JS、能跟上 2026 年新语法(如 CSS 原生嵌套、@layer)的样式校验工具。Sublime Text 上配它,核心就三步:装、连、调。
怎么让 SublimeLinter 找到并运行 stylelint
SublimeLinter 不会自动发现你项目里 node_modules/.bin/stylelint,尤其当你用 nvm 或 pnpm 时,路径经常错。
- 先确认 stylelint 已安装:
npm install --save-dev stylelint stylelint-config-standard-scss - 在 SublimeLinter 的用户设置(
Preferences → Package Settings → SublimeLinter → Settings)里,写死executable路径,比如:"executable": ["/Users/you/.nvm/versions/node/v20.15.0/bin/stylelint"]
(Mac/Linux)或"executable": ["C:\Users\you\AppData\Roaming\npm\stylelint.cmd"]
(Windows) - 别信“自动探测”,
path字段在最新版 SublimeLinter 中已弃用,只靠executable - 如果报
Cannot find module 'stylelint',说明路径指向的是 shell 命令而非 Node 模块入口,必须用node_modules/.bin/下的真实可执行文件路径
为什么 --config 必须是绝对路径,且不能用 .stylelintrc.js
SublimeLinter 启动时工作目录不一定是项目根目录,相对路径会失效;而 .stylelintrc.js 是动态模块,在 Sublime 的沙箱环境里无法 require —— 它只认 JSON/YAML 格式配置。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 把配置写成
stylelint.config.json放项目根目录,内容类似:{ "extends": "stylelint-config-standard-scss", "rules": { "scss/dollar-variable-pattern": "^[-a-z]+$", "max-nesting-depth": 4 } } - 在 SublimeLinter 设置中指定绝对路径:
"args": ["--config", "/your/project/path/stylelint.config.json"]
- 别用
~或$HOME,Sublime 不展开这些变量 - 如果项目用 monorepo 结构,每个包需单独配 config 和对应路径,不能共用一个全局 config
如何让保存时自动修复,又不破坏原有缩进风格
--fix-on-save 看似方便,但 stylelint 默认用 2 空格缩进、单引号、无分号 —— 和你团队的 prettier 或人工习惯冲突,一保存就格式爆炸。
- 加
--fix到args里,但必须同步配prettier规则,否则 stylelint 和 prettier 互相 undo - 推荐做法:关掉
--fix-on-save,改用命令面板(Ctrl+Shift+P)手动触发SublimeLinter: Fix this error,只修当前报错项 - 若真要全自动,务必在
stylelint.config.json里显式声明格式规则:"indentation": "tab", "string-quotes": "double", "declaration-colon-newline-after": "always-multi-line"
- SCSS 特有规则如
scss/at-rule-no-unknown要开,否则@use、@forward全被标红
真正难的不是配通,而是让 stylelint 理解你项目里混用的 CSS 原生嵌套 + SCSS 变量 + @layer 分层 —— 这需要 stylelint-config-standard-scss v9+ 和 stylelint v16+,低版本直接跳过新语法,等于没校验。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










