TypeScript类型判断变动疑惑及@nestjs/config读取env布尔值方案

类型判断不一致的根因 #

@nestjs/config的ConfigService.get<T>()方法的泛型<T>仅用于给TypeScript做静态类型标注，不会在运行时执行任何类型转换逻辑。你手动为泛型传入<boolean>，相当于主动告知TypeScript「该方法返回值为布尔类型」，但实际上.env文件的所有键值在原生加载时均为字符串类型，不存在的键会返回undefined，因此出现了静态类型校验结果和运行时实际类型脱节的问题。
你几次遇到的报错都是TypeScript基于你传入的<boolean>泛型推导的结果：

• 直接调用get<boolean>('enabled')时，TypeScript推导返回值类型为boolean | undefined
• 追加|| ''逻辑后，TypeScript推导整个表达式的类型为boolean | string（布尔值为false时会返回空字符串）
• 运行时因为实际返回值为字符串，||逻辑的执行结果和布尔判断预期完全不符，才会出现最终打印类型仍为字符串的问题。

正确读取布尔值的实现 #

首先对齐静态类型和运行时实际类型，读取时用<string>作为泛型参数，匹配.env实际返回的string | undefined类型，再做类型转换和默认值处理即可：

// 读取配置，类型标注匹配运行时实际返回结果
const enabledStr = this.configService.get<string>('enabled');
// 配置不存在时默认返回true，存在的话转换为布尔值
const enabled = enabledStr === undefined ? true : enabledStr.toLowerCase() === 'true';

如果需要兼容'1'、'off'、'no'这类常见的布尔配置写法，可以调整转换逻辑：

const enabled = enabledStr === undefined ? true : !['false', '0', 'off', 'no'].includes(enabledStr.toLowerCase());

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