Agent Skills
返回列表
小四环境变量加载

小四环境变量加载

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 想在启动阶段集中加载配置的后端工程师
  • 维护示例仓库想杜绝密钥入库的开源维护者
  • 散蒲公英式交付模板的技术写作者与布道者