文档 Grafana Alloy 参考 命令行界面 fmt

fmt 命令

fmt 命令用于格式化给定的 Alloy 配置文件。

用法

shell 复制

alloy fmt [<FLAG> ...] <FILE_NAME>

替换以下内容

• <FLAG>: 一个或多个定义命令输入和输出的标志。
• <FILE_NAME>: Alloy 配置文件。

如果未提供 <FILE_NAME> 参数，或者 <FILE_NAME> 参数等于 -，则 fmt 会格式化标准输入的内容。否则，fmt 会从参数指定的磁盘文件中读取并格式化该文件。

可以指定 --write 标志，用格式化后的结果替换磁盘上的原始文件内容。--write 只能在 fmt 不是从标准输入读取时使用。

可以指定 --test 标志来测试文件内容是否已正确格式化。

--write 和 --test 标志互斥。

如果正在格式化的文件包含语法不正确的 Alloy 配置，则命令将失败，但不会验证 Alloy 组件是否已正确配置。

支持以下标志

• --write, -w: 在不是从标准输入读取时，将格式化后的文件写回磁盘。
• --test, -t: 仅测试输入，如果会进行更改，则返回非零退出代码。