环境变量
也叫：.env、Env、环境配置
电脑或终端里存着的一串"名字 = 值"，程序运行时自己去读。密钥、服务器地址这类不该写进代码、每个人又不一样的东西，就放在这里。
先知道：API 密钥
你可能会这样说、这样问
“教程让我"把 API Key 填到 .env 文件里"，.env 是什么？”
.env 和 .env.example 有什么区别？
.env.example 是项目自带的"填空模板"，只写了要填哪些名字，值是空的或示例，可以放进仓库。你把它复制一份改名成 .env，填上自己的真实值；.env 只留在你电脑上，不上传、不分享。
为什么不直接把密钥写在代码里，多省事？
代码要分享、要提交、可能公开，写在里面的密钥就跟着出去了。放在环境变量里，代码里只写"去读名叫 XX 的变量"，谁拿到代码都看不到你的值（见API 密钥）。
打个比方
像酒店前台的保险柜：房卡（代码）上只写着"去 305 号柜子取"，真正的贵重物品（密钥）锁在柜子里。房卡丢了、借给别人看，柜子里的东西也不会跟着丢。
本页有 6 节，点开跳到任意一节
在项目里，它通常长这样
| 对比项 | .env.example | .env |
|---|---|---|
| 是什么 | 项目自带的填空模板 | 你自己复制出来、填了真实值的那份 |
| 里面写着 | OPENAI_API_KEY=（空着或示例） | OPENAI_API_KEY=你真实的密钥 |
| 能不能上传 | 可以，里面没有秘密 | 不能，只留在你电脑上 |
严格来说
项目里一般有个 .gitignore 文件，写着让 Git 忽略 .env。新建 .env 之前，先让 AI 确认一下它确实在忽略名单里，免得一提交就带上去了。
用的时候要注意
误区.env 截图发群里问问题没关系
截图里的密钥一样能被人抄走。问问题时把值打码，或者只发变量的名字。
误区改了 .env，程序马上就能读到新值
大多数程序只在启动时读一次。改完要把程序停掉再重新运行。
这样跟 AI 说
这个项目需要配置环境变量：（贴 README 里相关的说明，或者 .env.example 的内容，别贴真实的值）。请告诉我每个变量是干什么用的、去哪里拿；再帮我确认 .env 已经在 .gitignore 里，不会被提交上去。我自己来填真实的值，你不要让我把它发给你。
考考你
选择题 · 选一个你觉得最像的
项目里有一个 .env.example 文件，你该怎么用它？
接下来学什么
- 1Vibe Coding 入门 · 下一个（第 11 / 16 个）本地运行把项目在你自己的电脑上跑起来，用 localhost 加一个端口号，在浏览器里打开看。
- 2API 密钥调用 AI 服务的"钥匙"，和你的账户、额度绑在一起，不能发给别人。
- 3部署把在自己电脑上跑通的项目，放到一台一直开着的服务器上，换来一个别人也能打开的网址。
‹ 上一个：API 密钥 · Vibe Coding 入门第 10 / 16 个
在哪里接着学
延伸阅读 · 权威出处
出处：网站 Codex 教程第 9 课、Claude Code 教程第 7 课《MCP》；The Twelve-Factor App《配置》。最后更新 2026-10-17。