如何在对象解构中使用感叹号处理TypeScript环境变量类型报错

你遇到的是TypeScript对process.env属性的类型校验问题——默认情况下process.env的所有属性都是string | undefined类型，直接解构后赋值给需要string类型的参数时就会触发报错。你之前尝试的解构写法不符合TypeScript语法规范，以下是几种可行的解决方式：

方式一：对process.env整体做非空断言 #

如果能确保项目运行时process.env已经正确加载了所有需要的环境变量，可以直接对process.env整体添加非空断言，之后解构的变量会被推断为string类型：

const { VAR_A, VAR_B, VAR_C } = process.env!;

方式二：为单个变量添加非空断言 #

如果只想针对特定变量做非空断言，可以先解构再单独断言：

const { VAR_A, VAR_B, VAR_C } = process.env;
const varA = VAR_A!;
const varB = VAR_B!;
const varC = VAR_C!;

方式三：通过类型声明强制定义环境变量类型 #

从根源上解决类型问题，在项目中添加类型声明文件（比如env.d.ts），明确指定需要的环境变量为string类型：

declare global {
  namespace NodeJS {
    interface ProcessEnv {
      VAR_A: string;
      VAR_B: string;
      VAR_C: string;
    }
  }
}

// 确保这个文件被TypeScript识别为模块
export {};

之后直接解构就不会出现类型错误，同时还能获得代码提示。

方式四：给变量设置默认值（适合允许空值的场景） #

如果环境变量不存在时可以用默认值兜底，解构时直接赋值默认值：

const { VAR_A = 'default_a', VAR_B = 'default_b', VAR_C = 'default_c' } = process.env;

你之前的写法错误原因：TypeScript的非空断言!不能直接加在解构的属性名后，也不能加在整个解构表达式末尾，这些都是无效语法。

内容的提问来源于stack exchange，提问作者I.sh.