#CLI
anyl [OPTIONS] [FILES]...格式化每个文件并输出结果。未指定文件时从标准输入读取。
#选项
| 选项 | 说明 |
|---|---|
-w, --write | 直接覆盖文件。不能与 --check 同时使用。 |
-c, --check | 输出会被修改的文件路径;只要有一个文件会被修改,就以状态码 1 退出。 |
-p, --profile <PROFILE> | 内置配置文件名(html、vue)或配置文件 YAML 的路径。默认使用与各文件语言对应的内置配置文件。 |
--class-order <CLASS_ORDER> | 对静态 class 属性中的类排序:内置类顺序名(tailwind)或类顺序 YAML 文件的路径。会覆盖配置文件中的 classOrder。 |
-l, --language <LANGUAGE> | 标准输入的语言:html(默认)、vue、css、scss、sass、less。 |
-h, --help | 显示帮助。 |
-V, --version | 显示版本。 |
#语言
文件的语言由扩展名决定:
| 扩展名 | 语言 | 默认配置文件 |
|---|---|---|
.html, .htm | html | html |
.vue | vue | vue |
.css, .scss, .sass, .less | 样式表 | html(其 stylesheet 部分) |
其他扩展名会被报告为不支持。
#退出码
| 代码 | 含义 |
|---|---|
0 | 成功。使用 --check 时:没有文件会被修改。 |
1 | 使用 --check 时:至少有一个文件会被修改。 |
2 | 错误:文件无法读取、文件类型不支持、配置文件无效、输入无效或未知的 annealer-* 指令。 |
指定多个文件时,annealer 会格式化所有文件并逐一报告错误;只要有一个失败,就以 2 退出。
#示例
anyl src/App.vue # 输出结果
anyl --write src/**/*.vue # 直接覆盖
anyl --check index.html # 在 CI 中使用
anyl --profile my-profile.yaml page.html # 自定义配置文件
anyl --class-order tailwind src/**/*.vue # 对 Tailwind 类排序
cat App.vue | anyl --language vue # 标准输入