运行时配置

支持运行时访问的环境感知配置。

nitro.config.ts

import { defineConfig } from "nitro";

export default defineConfig({
  serverDir: "./",
  runtimeConfig: {
    apiKey: "",
  },
});

Runtime 配置允许你定义可以在运行时通过环境变量覆盖的配置值。

定义配置 Schema

在 nitro.config.ts 中声明你的运行时配置及默认值：

nitro.config.ts

import { defineConfig } from "nitro";

export default defineConfig({
  serverDir: "./",
  runtimeConfig: {
    apiKey: "",
  },
});

运行时访问

在你的处理器中使用 useRuntimeConfig 来访问配置值：

server.ts

import { defineHandler } from "nitro/h3";
import { useRuntimeConfig } from "nitro/runtime-config";

export default defineHandler((event) => {
  const runtimeConfig = useRuntimeConfig();
  return { runtimeConfig };
});

环境变量

通过带有前缀 NITRO_ 的环境变量来覆盖配置值：

.env

# 切勿提交敏感数据。本示例仅用于演示。
NITRO_API_KEY=secret-api-key

了解更多

配置

导入别名

自定义导入别名，使模块路径更简洁。