Stylelint¶
Stylelint 是一个流行的 CSS 代码风格检查工具。
本地运行¶
可以使用 mach 运行 Stylelint 的 mozlint 集成
$ mach lint --linter stylelint <file paths>
或者,省略 --linter stylelint
并运行所有已配置的代码风格检查工具,其中将包括 Stylelint。
Stylelint 还支持 --fix
选项来自动修复大多数规则引发的错误。
有关更多选项,请参阅 使用指南。
理解规则和错误¶
仅检查部分文件,有关详细信息,请参阅 配置。
根据设计,我们不会检查/格式化 reftests 和 crashtests,因为这些是专门设计的测试。
如果您不理解某个规则,可以在 stylelint.io 的规则列表 中查找有关该规则的更多信息。
常见问题及解决方法¶
此代码不应进行代码风格检查或格式化¶
如果是第三方代码片段,请将其添加到 ThirdPartyPaths.txt。
如果是生成的文件,请将其添加到 Generated.txt。
如果故意无效,请将其添加到 .stylelintignore。
配置¶
全局配置文件位于 topsrcdir/.stylelintrc.js
中。有关支持配置的概述,请参阅 Stylelint 的文档。
请尽量减少树中规则的差异。我们希望保持一致性,以便于开发人员使用。
来源¶
构建器¶
Gijs Kruitbosch (gijs) 负责构建器。您也可以在 Matrix 上的 #lint:mozilla.org 提问。
Stylelint 任务¶
这是一个一级任务。对于测试失败,应回退导致问题的补丁或修复问题。
一些错误可以使用 ./mach lint -l stylelint --fix path/to/file
修复。
对于测试工具问题,请在 Developer Infrastructure :: Lint and Formatting 中提交 Bug。