环境变量Environment Variable
已经放进环境变量了，为什么密钥还会出现在网页包里？
环境变量是进程从运行环境取得配置的一种方式，可用于区分开发、预览与生产设置。它不是自动的密钥保险箱；某些值会在构建时写入产物，带公开前缀的值可能进入浏览器。
代码从外部领取设置，但要看谁领到了。给浏览器的配置，用户就可能读到；只有服务端使用的私密值才应留在那里。
像同一份装配说明配不同任务单：测试车间和正式生产使用不同地址与参数。写在“内部设置”纸上，不代表纸不会被发出去。
类比到这里为止：工具对读取时机、公开前缀和覆盖顺序的规则不同。不能拿一种框架的变量规则当作所有运行环境的通用标准。
预览环境使用安全测试目标，生产用正式目标。邮件密钥只在服务端使用，页面展示的站点名称则可以公开。核对时确认是否存在，不把密钥打印到日志。
一项配置要问四个问题
- 可见范围
- 谁能读取：浏览器、服务端进程还是平台管理员？
- 读取时机
- 构建时固定，还是每次运行才取得？更改后需不需要重新构建或重启？
- 生效来源
- 本地文件、进程环境与平台设置发生冲突时，以哪一项为准？
- 缺失处理
- 缺少必要配置时明确失败，不能静默连接到另一个生产系统。
私密配置的生命周期也要考虑
密钥若进入公开包，应按暴露处理，撤销或轮换旧值并核对影响。仅把变量名改回不公开，无法让别人已经得到的值消失。
教学或排查报告只记录变量用途、所属环境和配置是否齐全，不要附真实值。公开教程可以用虚构占位文字说明。
继续看项目应用与交付检查
环境变量 在项目中负责什么
- 什么时候用
- 同一代码需要在不同环境运行，或配置地址、功能开关与服务凭据时。
- 它解决什么
- 将环境差异从业务代码中分离，让配置来源和部署目标可检查。
- 它不负责什么
- Next.js 的 NEXT_PUBLIC_、Vite 的 VITE_ 通常用于公开配置；具体行为看当前版本。改平台变量也不保证已经生成的前端产物立即变化。
- 放进真实项目
- 把 CRM 地址、公开域名和密钥引用分开配置到开发与正式环境。
环境变量把环境差异作为配置交给程序
本地、预览与生产可能使用不同地址、凭据和开关，要核对实际环境与读取时机。
- 01
列出敏感级别、来源与使用环境。
- 02
保护私密值，不放进前端包或日志。
- 03
检查覆盖规则，更改构建时变量后重新生成产物。
先分公开与私密，再看构建时还是运行时读取。
容易混淆的地方
.env 文件、平台变量与密钥管理服务不是同一种保存方式。忽略 Git 只防止未来误提交，不会清除已暴露的历史。
把邮件服务密钥放进 NEXT_PUBLIC_MAIL_KEY，认为环境变量不会被用户看见。哪里需要改？
你可以这样告诉 AI Agent
我在处理这件事：把 CRM 地址、公开域名和密钥引用分开配置到开发与正式环境。请以“环境变量”为主线，先说明它在这里负责什么、不负责什么；再列出必要输入、建议动作和可验证结果。用外贸独立站的业务语言回答，不确定的信息标为待确认。
内容依据与延伸
本站用原创中文解释把专业概念映射到外贸独立站；定义和机制继续以官方资料为准，业务例子再回到 外贸独立站询盘优化实战 验证。
本站整理说明：原创整理：Web 开发、产品设计、AI 协作与外贸独立站实践