Stylelint 是一个 CSS 代码检查工具，通过安装 stylelint 及对应语法包、创建配置文件 .stylelintrc.json、设置检查范围脚本、集成编辑器与 Git Hooks 实现自动化校验，帮助团队统一编码规范。
Stylelint 是一个强大的 CSS 代码检查工具，可以帮助你在项目中统一 CSS 编码规范，避免错误和不一致的写法。配置 Stylelint 并不复杂，关键在于根据项目需求选择合适的规则并正确集成到开发流程中。
安装 Stylelint
在项目根目录下通过 npm 或 yarn 安装 Stylelint：
npm install stylelint --save-dev如果你使用的是 SCSS、Less 或 CSS-in-JS，还需要安装对应的语法支持包，例如 SCSS：
npm install stylelint-scss --save-dev创建配置文件
在项目根目录创建 .stylelintrc.json 文件（也支持 .yaml 或 .js 格式），这是 Stylelint 的核心配置文件。
立即学习“前端免费学习笔记（深入）”；
一个基础配置示例：
{ "extends": "stylelint-config-standard", "rules": { "indentation": 2, "string-quotes": "single", "color-hex-case": "lower", "block-closing-brace-newline-after": "always", "declaration-colon-space-after": "always" } }说明：
- extends：继承官方推荐配置，开箱即用。
- rules：自定义具体规则，覆盖或补充默认规则。
如果你使用 SCSS，可以这样扩展：
{ "extends": [ "stylelint-config-standard", "stylelint-config-standard-scss" ], "plugins": ["stylelint-scss"], "rules": { "scss/percent-placeholder-pattern": "^[_][a-z]", "scss/at-import-no-partial-leading-underscore": true } }
指定检查文件范围
在 package.json 中添加脚本命令，指定要检查的文件：
"scripts": { "lint:css": "stylelint \"**/*.css\" \"**/*.scss\"" }你也可以创建 .stylelintignore 文件，忽略某些目录：
node_modules/ dist/ public/ *.min.css集成到编辑器和 Git Hooks
为了让检查更高效，建议集成到开发环境中。
- 在 VS Code 中安装 Stylelint 插件，保存时自动提示错误。
- 配合 lint-staged 和 husky 实现提交前自动检查：
在 package.json 中添加：
"lint-staged": { "*.{css,scss}": "stylelint" }然后设置 husky 在 pre-commit 阶段运行 lint-staged。
基本上就这些。配置完成后，运行 npm run lint:css 就能看到检查结果。根据团队规范调整 rules，逐步完善即可。不复杂但容易忽略细节，关键是坚持使用。
