跳到主要内容
前端术语库

环境变量

Environment Variable

前端工程也叫:.env、环境配置、env

一句话:放在代码之外、按运行环境区分的配置值,比如接口地址和密钥,避免把敏感信息写死在代码里。

详细解释

环境变量像酒店前台的保险箱:贵重物品(密钥、数据库密码)不放在行李(代码)里,而是单独存放,需要时再取。开发、测试、正式环境可以用不同的值,代码本身不用改。

前端项目通常把它们写在根目录的 .env 文件里。要特别注意:带 VITE_、NEXT_PUBLIC_ 这类前缀的变量会被打包进前端代码,任何人都能在浏览器里看到,所以真正的密钥不能放在前端变量里,应该放在后端或服务端函数中。

.env 文件要加入 .gitignore,不要提交到仓库;部署时在托管平台的设置里重新填写。修改 .env 后通常要重启开发服务器才生效。

怎么跟 AI 说

可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。

把接口地址和密钥从代码里移到 .env 文件中,用环境变量读取,并把 .env 加入 .gitignore,另外提供一个不含真实值的 .env.example。再检查有没有密钥会被打包进前端代码,如果有,告诉我怎么改。