Environment variables

在 Deno 中使用环境变量有几种方式：

内置 Deno.env 方法 Jump to heading#

Deno 运行时提供了对环境变量的内置支持，通过 Deno.env。

Deno.env 具有 getter 和 setter 方法。以下是 示例用法：

Deno.env.set("FIREBASE_API_KEY", "examplekey123");
Deno.env.set("FIREBASE_AUTH_DOMAIN", "firebasedomain.com");

console.log(Deno.env.get("FIREBASE_API_KEY")); // examplekey123
console.log(Deno.env.get("FIREBASE_AUTH_DOMAIN")); // firebasedomain.com
console.log(Deno.env.has("FIREBASE_AUTH_DOMAIN")); // true

.env 文件 Jump to heading#

Deno 也支持 .env 文件。您可以通过 --env-file 标志告诉 Deno 从 .env 中读取环境变量，例如：

deno run --env-file main.ts

这将从当前工作目录或包含 .env 文件的第一个父目录中读取 .env 文件。如果要从不同的文件加载环境变量，可以将该文件作为标志参数指定。

您可以传递多个 --env-file 标志（例如， deno run --env-file=.env.one --env-file=.env.two --allow-env <script>）以从多个文件加载变量。

@std/dotenv Jump to heading#

标准库中的 dotenv 包也可以用于从 .env 加载环境变量。

假设您有一个 .env 文件，如下所示：

GREETING="Hello, world."

导入 load 模块以自动从 .env 文件导入到进程环境中。

import { load } from "jsr:@std/dotenv";

const env = await load({
  // 可选：选择特定路径（默认为 ".env"）
  envPath: ".env.local",
  // 可选：也导出到进程环境（这样 Deno.env 可以读取它）
  export: true,
});

console.log(env.GREETING);
console.log(Deno.env.get("GREETING"));

运行此命令时使用 deno run --allow-read --allow-env app.ts。

有关 .env 处理的更多文档可以在 @std/dotenv 文档中找到。

在运行命令时设置变量 Jump to heading#

与其他 CLI 命令一样，您可以在运行命令之前设置环境变量，如下所示：

MY_VAR="my value" deno run main.ts

当您想根据环境变量更改任务时，这可能是有用的，并且可以与 deno task 命令结合使用，如下所示：

{

  ...
  
  "tasks": {
    "build:full": {
      "description": "使用所有功能构建站点",
      "command": "BUILD_TYPE=FULL deno run main.ts"
    },
    "build:light": {
      "description": "构建不包含昂贵操作的站点",
      "command": "BUILD_TYPE=LIGHT deno run main.ts"
    }
  }
}

MY_VAR="my value with spaces"

std/cli Jump to heading#

Deno 标准库具有 std/cli 模块 用于解析命令行参数。有关文档和示例，请参考该模块。

特殊环境变量 Jump to heading#

Deno 运行时具有以下特殊环境变量。