跳转到主要内容
让各个扩展界面的样式表质量保持一致,尽早发现 CSS 问题。Stylelint 通过脚本或持续集成(CI)运行,而不是跑在 Extension.js 的 dev/build 管线里。

什么场景适合用 Stylelint

  • 你在多个扩展界面之间维护共享的 CSS/Sass/Less。
  • 你希望在 PR 合并前进行样式质量检查。
  • 你需要在团队工作流中保持一致的样式表约定。

Stylelint 的能力

能力它能带来什么
CSS 质量检查抓出无效写法并强制执行样式约定
预处理器支持在一个工作流里 lint CSS、Sass 和 Less
脚本与 CI 集成在合并和发布前运行样式检查
与格式化工具对齐与 Prettier 搭配,减少样式工具间的冲突

模板示例

Stylelint 配置模板

预配置好的样式 lint 设置。 new-config-stylelint screenshot
npx extension@latest create my-extension --template=new-config-stylelint
仓库:examples/new-config-stylelint

在现有扩展中使用

安装 Stylelint 依赖:

Stylelint 配置

在项目根目录创建一个 Stylelint 配置文件(例如 .stylelintrc.json):
{
  "extends": "stylelint-config-standard-scss",
  "rules": {
    "color-no-invalid-hex": true,
    "block-no-empty": true
  }
}

运行 Stylelint

npm run lint:styles
如果你还没有相应脚本:

与 Prettier 集成

把 Stylelint 和 Prettier 整合在一起,可同时格式化和 lint 样式。安装以下依赖: 然后更新 .stylelintrc.json 把 Prettier 引入:
{
  "extends": [
    "stylelint-config-standard-scss",
    "stylelint-prettier/recommended"
  ]
}
这样可以让样式的格式化和 lint 保持对齐。

最佳实践

  • 准备一个专门的 lint:styles 命令,并在 CI 中运行它。
  • 在 monorepo 的多个扩展包之间使用同一份共享配置。
  • 把 Stylelint 与 Prettier 搭配使用,让样式格式化保持确定性。

检测说明

Extension.js 可以检测 Stylelint 配置文件以用于诊断/报告,但不会把 Stylelint 注入到构建管线中。

下一步

  • 学习如何把 Prettier 集成到格式化工作流。
  • 配置 PostCSS 来转换样式表。