2026-01-20 · TypeScript
用类型安全的配置加载环境变量
缺少变量时在启动阶段就失败,而不是凌晨两点才炸开。
前言
介绍把环境变量解析、补上默认值后放进冻结配置对象的模式,包含端口与布尔值的类型转换,以及清楚列出缺少哪些变量的错误信息。
常见的翻车姿势
跳过这一步的团队,通常会踩中三种坑:
- 优化了一个没人同意要动的数字。
- 照抄了约束完全不同的项目的方案。
- 一直推迟决策,直到反悔的代价高得吓人。
建议的切入方式
- 用用户的语言,一句话讲清楚问题。
- 选择一个每周都能度量的信号,而不是只在上线当天看一眼。
- 给小实验设定时间盒;两天的 spike 胜过两周的辩论。
小结
如果 TypeScript 教会了我们什么,那就是「无聊的一致性」打赢「聪明的一次性方案」。把学到的东西带回团队,别让它变成口口相传的都市传说。