AI 应用环境变量管理

一句话：把端口、数据库地址、API 密钥和环境差异从代码中分离出来。

它是什么

环境变量让同一份代码在开发、测试和生产环境使用不同配置。常见内容包括数据库连接、服务端口、外部 API、日志级别和功能开关。`.env` 文件不应提交真实密钥，部署平台中的变量也要设置访问权限。变量缺失、拼写错误和字符串类型误解是常见故障，因此应用启动时应进行配置校验。

适合干什么

• 适合 Node.js、Python、Docker、云平台和所有需要连接外部服务的应用。

不适合干什么

• 不适合把复杂业务数据全部放进环境变量，也不适合在前端变量中存放真正的秘密。

普通人怎么用

创建 `.env.example`，只保留变量名和说明，不写真实值。

进阶用户怎么用

进阶用户可按环境使用密钥管理服务、配置版本和自动部署校验。

常见误区

• 常见误区是变量名以 PUBLIC 开头仍然安全。被打包进浏览器的变量任何访问者都可能看到。

和相似工具的区别

• 环境变量适合部署配置，配置文件适合结构化非敏感设置。
• 后端变量可保密，前端构建变量通常会公开。
• Secrets Manager 比普通 `.env` 更适合团队生产环境。

入门步骤

• 关闭一个必填变量启动应用，确认系统能给出明确错误，而不是运行到中途才失败。