环境变量 – Runtime | Bun Docs

Bun 会自动读取你的 .env 文件，并提供惯用的方式来以编程方式读取和写入你的环境变量。此外，Bun 的运行时行为的某些方面可以通过 Bun 特有的环境变量进行配置。

设置环境变量

Bun 会自动读取以下文件（按优先级从低到高排序）。

.env
.env.production, .env.development, .env.test（取决于 NODE_ENV 的值）
.env.local

注意： 当 NODE_ENV=test 时，.env.local **不会**被加载。这可以防止在测试期间本地覆盖，从而确保不同执行之间的一致性测试环境。此行为与 Next.js 和 Create React App 等流行框架匹配。

.env
FOO=hello
BAR=world

也可以通过命令行设置变量。

Linux/macOS

Windows

Linux/macOS
FOO=helloworld bun run dev

Windows
# Using CMD
set FOO=helloworld && bun run dev

# Using PowerShell
$env:FOO="helloworld"; bun run dev

跨平台解决方案（带 Windows）

对于跨平台解决方案，您可以使用 bun shell。例如，bun exec 命令。

bun exec 'FOO=helloworld bun run dev'

在 Windows 上，通过 bun run 调用的 package.json 脚本会自动使用 **bun shell**，因此以下内容也具有跨平台性。

package.json
"scripts": {
  "dev": "NODE_ENV=development bun --watch app.ts",
},

或通过将属性分配给 process.env 来以编程方式设置。

process.env.FOO = "hello";

手动指定 `.env` 文件

Bun 支持 --env-file 来覆盖要加载的特定 .env 文件。您可以在 Bun 运行时运行脚本时，或在运行 package.json 脚本时使用 --env-file。

bun --env-file=.env.1 src/index.ts
bun --env-file=.env.abc --env-file=.env.def run build

引号

Bun 支持双引号、单引号和模板字面量反引号

.env
FOO='hello'
FOO="hello"
FOO=`hello`

展开

环境变量会自动进行展开。这意味着您可以在环境变量中引用先前定义的变量。

.env
FOO=world
BAR=hello$FOO

process.env.BAR; // => "helloworld"

这对于构造连接字符串或其他复合值很有用。

.env
DB_USER=postgres
DB_PASSWORD=secret
DB_HOST=localhost
DB_PORT=5432
DB_URL=postgres://$DB_USER:$DB_PASSWORD@$DB_HOST:$DB_PORT/$DB_NAME

可以通过用反斜杠转义 $ 来禁用此功能。

.env
FOO=world
BAR=hello\$FOO

process.env.BAR; // => "hello$FOO"

`dotenv`

总的来说，您不再需要 dotenv 或 dotenv-expand，因为 Bun 会自动读取 .env 文件。

读取环境变量

当前的环境变量可以通过 process.env 访问。

process.env.API_TOKEN; // => "secret"

Bun 还通过 Bun.env 和 import.meta.env 提供这些变量，后者是 process.env 的简单别名。

Bun.env.API_TOKEN; // => "secret"
import.meta.env.API_TOKEN; // => "secret"

要将所有当前设置的环境变量打印到命令行，请运行 bun --print process.env。这对于调试很有用。

bun --print process.env
BAZ=stuff
FOOBAR=aaaaaa
<lots more lines>

TypeScript

在 TypeScript 中，process.env 的所有属性都将被键入为 string | undefined。

Bun.env.whatever;
// string | undefined

为了获得自动补全功能并告诉 TypeScript 将变量视为非可选字符串，我们将使用接口合并。

declare module "bun" {
  interface Env {
    AWESOME: string;
  }
}

将此行添加到您项目的任何文件中。它将全局地将 AWESOME 属性添加到 process.env 和 Bun.env。

process.env.AWESOME; // => string

配置 Bun

Bun 读取这些环境变量并配置其行为的各个方面。

名称	描述
`NODE_TLS_REJECT_UNAUTHORIZED`	`NODE_TLS_REJECT_UNAUTHORIZED=0` 会禁用 SSL 证书验证。这对于测试和调试很有用，但您应该非常谨慎在生产环境中使用它。注意：此环境变量最初由 Node.js 引入，我们为了兼容性保留了名称。
`BUN_CONFIG_VERBOSE_FETCH`	如果 `BUN_CONFIG_VERBOSE_FETCH=curl`，则 fetch 请求会将 URL、方法、请求头和响应头记录到控制台。这对于调试网络请求很有用。这也可与 `node:http` 一起使用。`BUN_CONFIG_VERBOSE_FETCH=1` 等同于 `BUN_CONFIG_VERBOSE_FETCH=curl`，但没有 `curl` 输出。
`BUN_RUNTIME_TRANSPILER_CACHE_PATH`	运行时转译器缓存大于 50 KB 的源文件的转译输出。这使得使用 Bun 的 CLI 加载速度更快。如果设置了 `BUN_RUNTIME_TRANSPILER_CACHE_PATH`，则运行时转译器会将转译输出缓存到指定的目录。如果 `BUN_RUNTIME_TRANSPILER_CACHE_PATH` 设置为空字符串或字符串 `"0"`，则运行时转译器不会缓存转译输出。如果 `BUN_RUNTIME_TRANSPILER_CACHE_PATH` 未设置，则运行时转译器会将转译输出缓存到特定于平台的缓存目录。
`TMPDIR`	Bun 在打包或其他操作期间偶尔需要一个目录来存储中间资产。如果未设置，则默认为特定于平台的临时目录：Linux 上为 `/tmp`，macOS 上为 `/private/tmp`。
`NO_COLOR`	如果 `NO_COLOR=1`，则 ANSI 颜色输出将被禁用。
`FORCE_COLOR`	如果 `FORCE_COLOR=1`，则 ANSI 颜色输出将被强制启用，即使设置了 `NO_COLOR`。
`BUN_CONFIG_MAX_HTTP_REQUESTS`	控制 fetch 和 `bun install` 发送的并发 HTTP 请求的最大数量。默认为 `256`。如果您遇到速率限制或连接问题，可以减小此数字。
`BUN_CONFIG_NO_CLEAR_TERMINAL_ON_RELOAD`	如果 `BUN_CONFIG_NO_CLEAR_TERMINAL_ON_RELOAD=true`，则 `bun --watch` 不会在重新加载时清除控制台。
`DO_NOT_TRACK`	在崩溃时禁用将崩溃报告上传到 `bun.report`。在 macOS 和 Windows 上，崩溃报告上传默认启用。否则，截至 2024 年 5 月 21 日，尚未发送遥测数据，但我们计划在未来几周内添加遥测。如果 `DO_NOT_TRACK=1`，则自动上传崩溃报告和遥测都将被禁用。
`BUN_OPTIONS`	将命令行参数前置到任何 Bun 执行。例如，`BUN_OPTIONS="--hot"` 使 `bun run dev` 的行为类似于 `bun --hot run dev`。

运行时转译器缓存

对于大于 50 KB 的文件，Bun 会将转译输出缓存到 $BUN_RUNTIME_TRANSPILER_CACHE_PATH 或特定于平台的缓存目录。这使得使用 Bun 的 CLI 加载速度更快。

此转译器缓存是全局的，并跨所有项目共享。随时删除缓存是安全的。它是一个内容寻址缓存，因此永远不会包含重复条目。即使在 Bun 进程运行时删除缓存也是安全的。

建议在使用 Docker 等临时文件系统时禁用此缓存。Bun 的 Docker 镜像会自动禁用此缓存。

禁用运行时转译器缓存

要禁用运行时转译器缓存，请将 BUN_RUNTIME_TRANSPILER_CACHE_PATH 设置为空字符串或字符串 "0"。

BUN_RUNTIME_TRANSPILER_CACHE_PATH=0 bun run dev

它缓存什么？

它缓存

大于 50 KB 的源文件的转译输出。
文件的转译输出的 sourcemap

缓存文件的扩展名使用 .pile。