VSCode插件只是调用本地CLI工具的“遥控器”,真正校验依赖项目中安装的ESLint/Stylelint等工具及正确配置文件;装插件无反应90%因缺少本地依赖或配置路径错误。

VSCode 插件本身不执行代码校验,真正干活的是项目本地安装的 ESLint、Stylelint、Prettier 这类 CLI 工具;插件只是调用它们的“遥控器”。装了插件却没提示,90% 是本地依赖或配置文件没到位。
ESLint 插件没反应?先查 node_modules 里有没有 eslint
VSCode 的 ESLint 插件(ID: dbaeumer.vscode-eslint)默认只找项目根目录下的 node_modules/.bin/eslint。全局安装的 eslint 它基本无视。
- 在项目根目录运行
npx eslint --version,能输出版本号才说明本地装好了 - 如果报
command not found,立刻执行npm install --save-dev eslint - 用 pnpm/yarn 的项目,确认插件能读到对应
node_modules/.bin路径——某些旧版插件对 pnpm 支持不稳定,可临时加eslint.options显式指定cwd - 右下角状态栏看到 ESLint 图标显示 “Disabled”,点击它选 “Enable for Workspace”,不是点“Enable for User”
Stylelint 对 .module.css 或 styled-components 没反应?缺解析器或处理器
Stylelint 默认只处理标准后缀(.css、.scss),遇到 .module.css、.pcss 或 CSS-in-JS,必须手动告诉它怎么读。
- 对
.module.css类文件,在.stylelintrc里加overrides并指定customSyntax,比如"customSyntax": "postcss-less"(注意:不是所有语法都有对应包,postcss-less要npm install --save-dev postcss-less) - 用
styled-components?必须装stylelint-processor-styled-components,并在配置中写"processor": "stylelint-processor-styled-components" - 检查 VSCode 右下角语言模式是不是被误设为
plaintext——点击它,手动切回CSS或SCSS - 报
Cannot find module 'postcss'?补装:npm install --save-dev postcss
保存时自动修复失效?别碰 autoFixOnSave,改用 codeActionsOnSave
stylelint.autoFixOnSave 和 eslint.autoFixOnSave 这两个设置已在新版插件中弃用。继续配它们,等于白配。
- 统一用
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }(ESLint)或"source.fixAll.stylelint": true(Stylelint) - 只对特定语言启用:比如不想修 JSON,就别在
[json]块里配defaultFormatter,更别让 ESLint 去碰它 - 和 Prettier 共存时,
source.fixAll.eslint和source.fixAll.prettier别同时开——格式化会打架。推荐只开 ESLint 的修复,Prettier 仅做保存时格式化(靠editor.formatOnSave) - 手动触发一次看效果:
Ctrl+Shift+P→ 输入ESLint: Fix all auto-fixable Problems,如果报错,问题不在 VSCode 设置,而在 ESLint 运行环境
Vue/Svelte 单文件组件里的 标签不检查?配置没覆盖到
默认情况下,Stylelint 不主动解析 块,除非你明确告诉它“这个文件我要管”。
- 确保
.stylelintrc中有"files": ["**/*.vue"]或类似通配路径(不是只写"files": ["*.vue"]) - Vue 项目常用
postcss-html作为customSyntax,要额外安装:npm install --save-dev postcss-html - Svelte 同理,需配
"customSyntax": "postcss-svelte"并装对应包 - 检查
package.json的stylelint.config字段是否指向了正确配置文件——VSCode 插件有时会优先读这个,而不是根目录的.stylelintrc
最常被跳过的环节是:以为装了插件就万事大吉,结果连 node_modules 都没装全;或者把配置文件放在 src/ 下,指望它管整个项目。规则生效范围永远由文件路径向上查找最近的配置决定,不是由 VSCode 窗口打开的位置决定。











