如何获取NodeJS ProcessEnv自定义类型的keyof并实现参数校验？

NodeJS.ProcessEnv默认带有字符串索引签名（[key: string]: string | undefined），这导致keyof NodeJS.ProcessEnv的类型是string | number——换句话说，你的函数参数实际上接受任意字符串，自然不会对非法键名报错，即便智能提示能识别合法选项。

方案一：自动提取已知键（推荐） #

编写一个类型工具过滤掉索引签名的影响，只保留ProcessEnv中明确声明的属性键（包括你自定义的和@types/node自带的默认键）：

// 类型工具：提取接口中明确声明的属性键（排除索引签名）
type KnownKeys<T> = {
  [K in keyof T]: string extends K ? never : number extends K ? never : K;
} extends { [_ in keyof T]: infer U } ? U : never;

// 仅获取ProcessEnv中明确声明的合法键
type EnvTypes = KnownKeys<NodeJS.ProcessEnv>;

const someFunction = (envKey: EnvTypes) => {
  // ...你的函数逻辑
};

someFunction('MY_VAR'); // 此处会触发类型错误，符合预期

这个方法会自动同步ProcessEnv的所有明确声明的键，无需手动维护。

方案二：手动维护合法键联合类型 #

如果需要严格限定允许的环境变量键，可以直接定义一个联合类型，并同步扩展ProcessEnv：

// 定义所有合法的环境变量键
type ValidEnvKeys = 'SOME_VAR' | 'SOME_OTHER_VAR' | 'NODE_ENV';

// 扩展ProcessEnv，确保接口与合法键一致
declare global {
  namespace NodeJS {
    interface ProcessEnv extends Record<ValidEnvKeys, string> {}
  }
}

const someFunction = (envKey: ValidEnvKeys) => {
  // ...你的函数逻辑
};

someFunction('MY_VAR'); // 此处会触发类型错误，符合预期

这种方法需要手动同步ValidEnvKeys和ProcessEnv的扩展内容，但类型约束更直观，适合需要精准控制环境变量范围的场景。

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