如何在TypeScript中正确使用环境变量，避免undefined类型报错？

这里提供4种可根据场景选择的实现方案，无需逐个对环境变量做显式判断：

方案1：非空断言（临时快速解决） #

如果你100%确定对应的环境变量在所有运行环境中都已经正确配置，可以直接在变量后加!非空断言，告诉TS编译器该变量一定存在：

const db = process.env.DB_URL!

注意：该方案仅做编译层面的类型忽略，运行时如果变量确实不存在依然会引发问题，仅适合临时调试、小项目使用。

方案2：自定义统一校验函数 #

写一个全局的环境变量加载函数，统一校验所有必要的环境变量，启动阶段如果缺失就直接抛出错误终止运行，避免业务代码中分散判断：

// src/utils/env.ts
function loadRequiredEnv() {
  // 列出所有需要的必要环境变量
  const requiredKeys = ['DB_URL', 'PORT', 'JWT_SECRET'] as const
  const env = {} as Record<typeof requiredKeys[number], string>

  for (const key of requiredKeys) {
    const value = process.env[key]
    if (!value) {
      throw new Error(`启动失败，缺失必要环境变量：${key}`)
    }
    env[key] = value
  }
  return env
}

export const env = loadRequiredEnv()

业务代码中直接导入使用即可，类型自动推导为非空的string：

import { env } from './utils/env'
const db = env.DB_URL // 无类型报错，无需判断

方案3：扩展ProcessEnv全局类型 #

在项目的类型声明文件中重写NodeJS的ProcessEnv接口，提前声明所有你会用到的环境变量类型，TS编译器就不会再提示undefined：

// src/env.d.ts
declare global {
  namespace NodeJS {
    interface ProcessEnv {
      DB_URL: string;
      PORT: string;
      JWT_SECRET: string;
    }
  }
}
export {}

注意：该方案同样仅修改编译时类型，建议搭配启动时的统一校验逻辑使用，避免运行时变量缺失。

方案4：使用校验库做类型+格式双校验（推荐中大型项目使用） #

如果需要同时校验环境变量的格式（比如DB_URL是合法URL、PORT是数字），可以用Zod等校验库实现：

// src/utils/env.ts
import { z } from 'zod'

// 定义环境变量的格式规则
const envSchema = z.object({
  DB_URL: z.string().url('DB_URL必须是合法的链接地址'),
  PORT: z.coerce.number().default(3000), // 自动转数字，缺省用3000
  JWT_SECRET: z.string().min(8, 'JWT_SECRET长度不能小于8位')
})

// 校验process.env，不匹配直接抛出错误终止启动
export const env = envSchema.parse(process.env)

该方案会自动推导env的类型，同时做存在性、格式校验，还支持配置默认值，是最严谨的实现方式。

内容的提问来源于stack exchange，提问作者Islam Hanafi Mahmoud