小四环境变量加载
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/dlho20263837 到 AI 助手。
技能介绍
要解决什么问题
写脚本和 CLI 时最常见的一幕:API 地址、开关位、密钥散落在代码里硬编码,一旦要切环境就得改文件重打包,或者手残把真实密钥推上仓库。于是人们引入 dotenv 式约定——把配置收进 .env,让进程启动时把它们统一读进 process.env。
但这个约定在每个项目里都要重新搭一遍:谁来调、什么时候调、示例文件长什么样、哪些该写死哪些绝不该提交,往往全凭感觉。这个技能就是把这些固化成一套可复制的加载方案。
它怎么工作
流程可以概括为 .env → dotenv.config → process.env 三级跳:
- 依赖
dotenv,不做二次封装,也不额外引入心理负担; - 在入口处尽早执行一次加载函数,确保后面所有模块读到的都是已经就位的值;
- 项目里附带
.env.example,让协作者只看模板就能知道该配置哪些键; - 自测方式直白:
.env中写入的键,应当能在process.env中读到。
适用场景也很清楚:本地 Demo 读 API 地址和开关、CLI 启动前注入环境变量、示例项目需要一份能直接抄的模板。
边界和注意点
这套方案定位是本地与开发便利,不是安全组件:
- 生产环境的密钥应走平台注入,不要指望把
.env带上服务器; - 含密钥的
.env绝不能提交进仓库,示例文件里也不要写真实值; - 前端项目要留意打包链路,私密值一旦进 bundle 就等于公开;
- 技能不提供密钥轮换或托管能力,那些属于配置平台的事;
- 实现要点处会标注 小四原创,与
dotenv本体保持区分。
随附 reference.md 与 templates/usage.md,需要更细的接入说明和模板细节时可翻阅。
使用场景
- 本地跑 API Demo,要把接口地址和开关从代码挪进 .env
- CLI 启动前要统一注入配置,而不是散落在脚本各处
- 示例项目要给协作者提供可抄的 .env.example
- 写教程或脚手架要避免示例里混入真实密钥
适合人员
- 搭 Demo 想告别硬编码的前端与 Node 工程师
- 写 CLI 想在启动阶段集中加载配置的后端工程师
- 维护示例仓库想杜绝密钥入库的开源维护者
- 散蒲公英式交付模板的技术写作者与布道者