2026-01-20 · TypeScript

用类型安全的配置加载环境变量

缺少变量时在启动阶段就失败,而不是凌晨两点才炸开。

前言

介绍把环境变量解析、补上默认值后放进冻结配置对象的模式,包含端口与布尔值的类型转换,以及清楚列出缺少哪些变量的错误信息。

常见的翻车姿势

跳过这一步的团队,通常会踩中三种坑:

  • 优化了一个没人同意要动的数字。
  • 照抄了约束完全不同的项目的方案。
  • 一直推迟决策,直到反悔的代价高得吓人。

建议的切入方式

  1. 用用户的语言,一句话讲清楚问题。
  2. 选择一个每周都能度量的信号,而不是只在上线当天看一眼。
  3. 给小实验设定时间盒;两天的 spike 胜过两周的辩论。

小结

如果 TypeScript 教会了我们什么,那就是「无聊的一致性」打赢「聪明的一次性方案」。把学到的东西带回团队,别让它变成口口相传的都市传说。