环境变量

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

Built-in Deno.env Methods Jump to heading#

The Deno runtime provides built-in support for environment variables through Deno.env.

Deno.env has getter and setter methods. Here is an example:

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="你好，世界。"

导入 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 文档中找到。

Set variables when running a command Jump to heading#

As with other CLI commands, you can set environment variables before running a command, as follows:

MY_VAR="my value" deno run main.ts

This can be useful when you want to change a task based on environment variables, and it can be combined with the deno task command, as follows:

{

  ...
  
  "tasks": {
    "build:full": {
      "description": "Build the site with all features",
      "command": "BUILD_TYPE=FULL deno run main.ts"
    },
    "build:light": {
      "description": "Build the site without expensive operations",
      "command": "BUILD_TYPE=LIGHT deno run main.ts"
    }
  }
}

MY_VAR="my value with spaces"

特殊环境变量 Jump to heading#

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