fmt

rs fmt 命令用于格式化文件或检查文件格式。详细用法请参考格式化指南。

用法

rs fmt [options] [files/globs...]

可以传入文件、目录或 glob 模式来指定格式化范围。不传入路径时，rs fmt 会格式化当前目录。路径解析和忽略规则请参考格式化范围。

示例：

# 格式化当前目录中的文件
rs fmt

# 格式化指定文件和目录
rs fmt src package.json

# 在 CI 中检查格式
rs fmt --check

rs format 是 rs fmt 的别名：

rs format

检查文件是否已格式化，但不修改文件。输出会列出存在格式问题的文件，并提供便于阅读的汇总信息，因此适合在 CI 中使用：

rs fmt . --check

--check 不能与 --write 或 --list-different 同时使用。

该命令使用以下退出状态码：

显示命令用法和选项信息，但不格式化文件：

rs fmt --help

输出未格式化文件的路径，但不提供 --check 的汇总信息。需要将结果交给其他命令处理时，可以使用此选项：

rs fmt . --list-different

此选项与 --check 使用相同的退出状态码，且不能与 --write 或 --check 同时使用。

将格式化 worker 的最大数量设置为正整数：

rs fmt . --parallel-workers 4

省略此选项时，rs fmt 会根据可用的 CPU 并行度和匹配的文件数量，自动选择最多 8 个 worker。在资源受限的环境中，可以设置较小的值来限制 CPU 或内存用量。

将 stdin 传入的内容按保存在 <path> 的文件进行格式化。该路径用于确定 parser 和匹配的覆盖配置，但不需要在磁盘上真实存在。格式化结果会输出到 stdout：

cat src/index.ts | rs fmt --stdin-filepath src/index.ts

--stdin-filepath 不能与文件参数或 --write、--check、--list-different 同时使用。详细说明请参考格式化标准输入。

将格式化结果写回文件。这是默认模式，因此可以省略 --write：

rs fmt src --write

--write 不能与 --check 或 --list-different 同时使用。