如何在TypeScript中正确使用dotenv/.env传递参数？

针对你遇到的process.env.NAME类型为string | undefined，无法传递给要求string类型参数的函数的问题，这里有几种更合理的解决方案：

1. 提前校验环境变量（最推荐） #

在程序启动时就检查必要的环境变量是否存在，不存在则直接抛出错误。这样既能提前发现配置缺失，TypeScript也会自动将process.env.NAME的类型收窄为string：

// App.ts
import { printName } from "./printStuff"
import * as dotenv from 'dotenv'
dotenv.config()

// 校验环境变量是否存在
if (!process.env.NAME) {
  throw new Error("必须配置环境变量NAME")
}

await printName(process.env.NAME)

这种方式的优势是从根源避免了空值问题，不会让程序带着缺失的配置继续运行，减少后续排查问题的成本。

2. 为process.env添加类型声明 #

创建一个类型声明文件，明确环境变量的类型，让TypeScript知道process.env.NAME是string类型：

// env.d.ts
declare global {
  namespace NodeJS {
    interface ProcessEnv {
      NAME: string;
    }
  }
}

export {}

然后在tsconfig.json中确保该文件被包含：

{
  "include": ["env.d.ts", "**/*.ts"]
}

注意：这种方式只是告诉TypeScript变量的类型，不会做运行时校验，所以最好和上面的校验方法配合使用，避免实际环境中缺失变量导致运行时错误。

3. 谨慎使用类型断言 #

如果你百分百确定.env文件中一定存在NAME变量，可以用类型断言强制告诉TypeScript该值不是undefined：

await printName(process.env.NAME as string)

但要注意：如果实际环境中缺失该变量，运行时会传入undefined，可能导致程序报错，所以只适合完全可控的场景。

4. 使用空值合并运算符（比||更严谨） #

如果确实允许传入空字符串，但想更精准地处理undefined的情况，可以用空值合并运算符??代替||，它只会在值为null或undefined时返回默认值，不会把0、false等假值当成空：

await printName(process.env.NAME ?? '')

内容的提问来源于stack exchange，提问作者Huckleberry Carignan