The CLI

The stylelint CLI

安装

stylelint 是一个 npm 包。使用以下命令进行安装：

npm install -g stylelint

用法

stylelint --help 打印命令行的文档。

命令行将格式化后的结果输出到 process.stdout，你可以自行阅读或输出到其他地方（如，将信息写到一个文件）

例子

查找 .stylelintrc，检测 foo 目录下的所有的 .css 文件：

stylelint "foo/*.css"

查找 .stylelintrc，检测 stdin：

echo "a { color: pink; }" | stylelint

使用 bar/mySpecialConfig.json 配置，检测 foo 目录下的所有的 .css 文件，然后写入到 myTestReport.txt：

stylelint "foo/*.css" --config bar/mySpecialConfig.json > myTestReport.txt

使用 bar/mySpecialConfig.json 配置，启用安静模式，检测 foo 目录及其子目录下的所有的 .css 文件，bar directory下的 .css 文件，然后以 JSON 格式输出到 myJsonReport.json：

stylelint "foo/**/*.css bar/*.css" -q -f json --config bar/mySpecialConfig.json > myJsonReport.json

使用 syntax 选项，检测 foo 目录下的所有 .scss 文件：

stylelint "foo/**/*.scss" --syntax scss

除了 --syntax scss，默认情况下，stylelint 也支持 --syntax less 和 --syntax sugarss。如果你使用了其中的一个，你可以不提供 --syntax 选项：非标准的远方可以根据 .less，.scss 和 .sss的扩展名推断出来是哪种语法。

此外，stylelint 可以接受一个自定义的 PostCSS 兼容语法。为了使用自定 语法，需要提供一个语法的模块名或语法文件的路径：--custom-syntax custom-syntax 或 --custom-syntax ./path/to/custom-syntax。

但是请注意，stylelint 对核心规则与非默认的语法是否可以正常工作不提供任何保证。

语法错误

命令行会通知你 CSS 文件中的语法错误。它使用同检测警告同样的格式。错误名称是 CssSyntaxError。

退出代码

命令行退出进程使用以下退出码：

• 1: Something unknown went wrong.