environment-variables

环境变量

以下是向项目中添加环境变量的方法：

1. 添加到 .env.example：

   NEW_VARIABLE=value_example
   

2. 添加到 apps/web/env.ts：

   // 仅供服务端使用的变量
   server: {
     NEW_VARIABLE: z.string(),
   }
   // 客户端使用的变量
   client: {
     NEXT_PUBLIC_NEW_VARIABLE: z.string(),
   }
   experimental__runtimeEnv: {
     NEXT_PUBLIC_NEW_VARIABLE: process.env.NEXT_PUBLIC_NEW_VARIABLE,
   }
   

3. 对于客户端使用的变量：

   • 必须以 NEXT_PUBLIC_ 为前缀
   • 添加到 client 和 experimental__runtimeEnv 部分

4. 在 turbo.json 的 globalDependencies 下添加：

   {
     "tasks": {
       "build": {
         "env": [
           "NEW_VARIABLE"
         ]
       }
     }
   }
   

示例：

• 输入：|

  添加服务端 API 密钥

  .env.example

  API_KEY=your_api_key_here

  env.ts

  server: { API_KEY: z.string(), }

  turbo.json

  "build": { "env": ["API_KEY"] } 输出："已正确添加服务端环境变量"

• 输入：|

  添加客户端功能标志

  .env.example

  NEXT_PUBLIC_FEATURE_ENABLED=false

  env.ts

  client: { NEXT_PUBLIC_FEATURE_ENABLED: z.coerce.boolean().default(false), }, experimental__runtimeEnv: { NEXT_PUBLIC_FEATURE_ENABLED: process.env.NEXT_PUBLIC_FEATURE_ENABLED, }

  turbo.json

  "build": { "env": ["NEXT_PUBLIC_FEATURE_ENABLED"] } 输出："已正确添加客户端环境变量"

参考：

• apps/web/env.ts
• apps/web/.env.example
• turbo.json