Stylelint 在 VSCode 不报错,主因是本地依赖缺失、配置文件未正确设置或语言绑定失败;需安装 stylelint 及对应配置包,创建 .stylelintrc.json,配置 stylelint.validate 支持 scss/less/vue 等语言,并确保右下角语言模式为小写匹配项。

Stylelint 在 VSCode 里不报错,基本可以断定不是插件没装,而是校验链断在了本地依赖、配置文件或语言绑定这三个环节中的某一个。
项目根目录有没有 stylelint 和配置文件
VSCode 的 Stylelint 插件只是“调度器”,它不带规则、不带解析器,真正干活的是你项目里安装的 stylelint 包和配置文件。没有这两样,插件静默退出,连错误提示都不会有。
- 运行
npm install --save-dev stylelint stylelint-config-standard(SCSS 项目请换用stylelint-config-standard-scss) - 在项目根目录创建
.stylelintrc.json,内容至少含:{"extends": "stylelint-config-standard"} - 不要用
.stylelintrc.js或stylelint.config.js,除非你明确需要 JS 配置逻辑——很多团队因大小写或导出方式写错导致配置不生效
stylelint.validate 没配对语言类型
VSCode 默认只对 .css 文件触发 Stylelint,.scss、.less、.vue 等统统跳过,除非你显式声明并确保语言模式匹配。
- 在工作区
.vscode/settings.json中加:"stylelint.validate": ["css", "scss", "less", "vue"]
(注意:全部小写,“SCSS”或“Vue”会失效) - 右下角点击当前语言模式(比如显示 “Plain Text” 或 “CSS”),手动选成
scss、less或vue—— 这步漏掉,上面的配置就白写了 - 若用
.module.css或.page.scss这类自定义后缀,必须在.stylelintrc.json里加overrides声明,否则文件根本不会被读取
自动修复只修一半,别怪插件
stylelint --fix 天然只支持无歧义的格式类规则,比如分号、引号、空格;所有涉及语义判断的(如选择器权重、重复声明、BEM 命名)一律不自动修复。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。
立即学习“前端免费学习笔记(深入)”;
- VSCode 1.84+ 已弃用
stylelint.autoFixOnSave,改用:"editor.codeActionsOnSave": {"source.fixAll.stylelint": true} - 如果修复后样式变乱,大概率是和 Prettier 冲突——关掉
editor.formatOnSave,或禁用css.format.enable,让 Stylelint 独占样式层 - 报
Cannot find module 'postcss'?补装:npm install --save-dev postcss postcss-scss(SCSS 项目)
Vue / Svelte 单文件组件里的 <style></style> 标签不检查
Stylelint 默认完全忽略 <style></style> 块内容,它只认独立文件。想让它进 <style lang="scss"></style>,得靠处理器告诉它“这里面是 CSS”。
- Vue 项目:装
stylelint-processor-html,并在.stylelintrc.json中加"processor": "stylelint-processor-html"
- Svelte 项目:装
stylelint-processor-svelte,同理指定processor - 别漏掉
stylelint-config-recommended-vue或对应框架预设——否则lang="scss"会被当成普通 CSS 解析,大量误报
最常被忽略的一点:VSCode 的语言模式识别是大小写敏感且可被 files.associations 覆盖的。哪怕配置全对,右下角显示的是 “SCSS (syntax)” 而不是小写的 “scss”,校验照样不会启动。

















