Stylelint命令报“command not found”需本地安装并用npx执行:运行npm install --save-dev stylelint stylelint-config-standard,脚本统一用npx stylelint或package.json中定义,避免全局安装;配置文件须为stylelint.config.js等合法名称且用module.exports导出,SCSS/Vue等需额外配置syntax和plugins。

Stylelint 命令报 command not found 怎么办
本地安装后直接运行 stylelint 报错,不是环境坏了,而是没走对路径。团队协作必须用项目级本地安装,别碰 npm install -g stylelint。
- 执行
npm install --save-dev stylelint stylelint-config-standard,确保package.json里有对应依赖 - 所有脚本都走
npx stylelint或写进package.json的"scripts",比如:"lint:css": "stylelint \"src/**/*.css\"" - CI 或某些 Shell 环境中,
node_modules/.bin可能不在$PATH,靠npx能绕过这个问题
.stylelintrc 文件不生效的常见原因
配置写了却没反应,90% 是文件名、导出方式或加载路径出了问题。Stylelint 不会自动向上找配置,只认当前工作目录下的合法文件。
- 文件名必须是
stylelint.config.js、.stylelintrc.js或stylelint.config.cjs;.stylelintrc(无后缀)容易误匹配,不推荐 - 必须用
module.exports = { ... }导出对象,不能写export default(除非你明确用了 ESM +type: "module") - 如果项目根目录下有
src/子目录,而你在src/里执行命令,Stylelint 就找不到根目录的配置文件——统一在项目根目录运行命令
SCSS/Vue/SFC 里的样式不被检查?
默认只处理 .css 文件,其他格式要手动“认领”。不是插件没装,是 Stylelint 根本没意识到那些内容需要解析。
- 用 SCSS:装
postcss-scss和stylelint-scss,并在配置里加"syntax": "scss"和"plugins": ["stylelint-scss"] - Vue 单文件组件:装
stylelint-config-recommended-vue,extends里加上它,并确保 VS Code 的stylelint.validate设置里包含vue - 自定义后缀如
.module.css:用overrides显式声明,例如:"files": ["**/*.module.css"],并配好customSyntax
VS Code 里 Stylelint 没提示、不修复
插件装了≠能用。它只是个壳,背后全靠本地 stylelint 包和配置驱动。
立即学习“前端免费学习笔记(深入)”;
- 确认
stylelint.enable在 VS Code 设置里为true;右下角语言模式要是CSS或SCSS,不是plaintext -
autoFixOnSave只对autofixable规则起作用(比如color-hex-case),像selector-class-pattern这类规则无法自动修,别指望它全包 - 如果和 Prettier 共存,关掉 Prettier 对 CSS 的格式化,或在
.stylelintrc里把冲突规则设为null,例如:"indentation": null


















