环境变量 API 参考

添加于： astro@5.0.0

astro:env API 允许你为你设置的环境变量配置一个类型安全的模式。这允许你指定它们在服务端或客户端是否可用，并定义它们的数据类型和附加属性。有关示例和用法说明，请参阅 astro:env 指南。

从 `astro:env` 导入

import {
  getSecret,
 } from 'astro:env/server';

添加于： astro@5.0.0

getSecret() 辅助函数允许通过键来检索环境变量的原始值。

例如，你可以将布尔值作为字符串检索

import {
  FEATURE_FLAG, // boolean
  getSecret
} from 'astro:env/server'

getSecret('FEATURE_FLAG') // string | undefined

这对于获取模式中未定义的机密信息也很有用，例如那些依赖于数据库或 API 动态数据的机密信息。

如果你需要以编程方式检索环境变量，我们建议使用 getSecret() 而不是 process.env（或等效方法）。因为它的实现是由你的适配器提供的，所以如果你切换适配器，你就不需要更新所有的调用。在开发和构建时，它默认为 process.env。