环境变量

一句话：环境变量是存放API Key、数据库地址、运行模式等配置的方式，常见文件是 .env。

它是什么

环境变量可以理解为项目运行时读取的外部配置。它常用来保存密钥、端口、数据库地址、模型名称等信息，让代码不用把敏感内容直接写死在文件里。

适合干什么

• 接入OpenAI、Claude、DeepSeek等API的人
• 部署网页应用或后端服务的人
• 看到 .env、API_KEY、DATABASE_URL 不懂的人
• 需要保护密钥的新手

不适合干什么

• 完全不接触API和部署的人
• 只在网页端使用AI工具的人
• 不需要配置任何密钥的静态页面

普通人怎么用

• 在项目根目录创建 .env 文件
• 按 KEY=value 的格式填写配置
• 不要在值两边乱加中文引号
• 重启项目让配置生效
• 确认 .env 已被 .gitignore 忽略

进阶用户怎么用

• 区分本地、测试、生产环境的不同变量
• 在部署平台的环境变量面板里填写密钥
• 为前端公开变量和后端私密变量做区分
• 定期轮换泄露过或不确定是否泄露的Key

常见误区

• 把 .env 提交到GitHub
• 变量名拼错，代码读取不到
• 修改 .env 后没有重启服务
• 把后端密钥暴露到前端页面

和相似工具的区别

• .env vs 代码配置：.env适合放不同环境会变化或敏感的配置，代码配置适合固定逻辑。
• 公开变量 vs 私密变量：公开变量可能进入浏览器，私密变量只能留在服务端。API Key通常不能放到前端公开变量。

入门步骤

• 查看项目文档需要哪些变量
• 复制 .env.example 为 .env
• 填写真实值
• 确认 .gitignore 包含 .env
• 重启项目测试

推荐工具（第三方）

VS Code、Vercel Environment Variables、Railway Variables、dotenv、1Password