环境变量

用于配置 Biome 行为的环境变量列表。

以下环境变量用于配置 Biome 及其 npm 包。

`BIOME_DISTRIBUTION`

覆盖 biome upgrade 检测到的安装来源。

支持以下安装来源：

当 biome upgrade 无法正确检测 Biome 的安装方式时（例如自定义前缀下的 Homebrew 安装），使用此项。

BIOME_DISTRIBUTION=homebrew biome upgrade

将 check、lint、format 和 ci 等命令的内部 CLI 日志写入指定文件。

在排查未预期行为时，用它来保存详细的 CLI 日志。

BIOME_LOG_FILE=biome-debug.log BIOME_LOG_LEVEL=debug biome check .

Biome 守护进程存储其日志文件的目录。

在排查编辑器集成问题时，用它把守护进程日志保存在项目专属目录中。

BIOME_LOG_PATH="$PWD/.biome-logs" biome start

添加到守护进程日志文件名前的前缀。默认为 server.log。

用它来区分共用同一日志目录的不同项目的日志。

BIOME_LOG_PREFIX_NAME=my-project.log biome start

控制 check、lint、format 和 ci 等命令的内部日志。默认为 none。

支持以下日志级别：

在检查一个项目时，用它来查看 Biome 内部的 CLI 活动。

BIOME_LOG_LEVEL=debug biome check .

控制 check、lint、format 和 ci 等命令的内部日志格式。默认为 pretty。

支持以下日志格式：

在持续集成（CI）中用它来收集机器可读的内部日志。设置 BIOME_LOG_LEVEL 以启用日志。

BIOME_LOG_LEVEL=info BIOME_LOG_KIND=json biome ci .

Biome 配置文件或目录的路径。

用它来应用存储在当前目录之外的共享配置。

BIOME_CONFIG_PATH="$HOME/.config/biome/biome.json" biome check .

biome ci 使用的工作线程数量。默认为自动选择。

用它来在资源受限的 CI runner 中限制 CPU 占用。

BIOME_THREADS=2 biome ci .

选择 Biome 守护进程使用的文件监视器。默认为 recommended。

支持以下文件监视策略：

当原生的文件通知不可靠时（例如在网络驱动器或挂载的文件系统上），使用 polling。

BIOME_WATCHER_KIND=polling biome start

当 BIOME_WATCHER_KIND 设为 polling 时，Biome 守护进程使用的轮询间隔（以毫秒为单位）。默认为 2000 毫秒（两秒）。

用它来调整轮询监视器检测到变更的快慢。

BIOME_WATCHER_KIND=polling BIOME_WATCHER_POLLING_INTERVAL=1000 biome start

覆盖 @biomejs/biome npm 包所使用的 Biome 二进制文件。如果不设置此变量，该包会自动为你的平台选择正确的二进制文件。

用它来通过 @biomejs/biome 包运行系统安装的或本地构建的二进制文件。

BIOME_BINARY=/usr/local/bin/biome npx @biomejs/biome check

当 Biome 发生 panic 时捕获回溯（backtrace），这有助于确定 panic 发生的位置。

在报告 Biome 的 panic 时，用它来附上有助于定位问题的堆栈跟踪。

RUST_BACKTRACE=1 biome check .