环境变量与密钥安全：别把 API Key 提交到 GitHub

配置分离不等于天然保密

先区分可公开标识、服务端私密凭据和不同环境的值。浏览器产物、构建日志、错误响应与截图可能暴露配置；环境变量不是私密保险箱。本页没有事故比例统计。

提交前按文件检查

真实值保存在适当私密配置或凭据管理方案中，示例只列变量名及非敏感说明。排除私密文件和依赖目录，检查暂存差异，不只搜索单一密钥前缀。已被跟踪的文件不会因后来加入gitignore就从历史消失。

部署时分清生效阶段

构建阶段可能把值写入静态资源，运行阶段可能由服务端读取。逐项记录用途、读取阶段和改值后是否需重建或重启；查框架当前说明，私密凭据不放在公开前缀变量中。

泄露后先轮换

GitHub官方建议先吊销或轮换敏感凭据，再处理仓库历史。随后评估克隆、fork、构建产物、日志和服务商调用记录。删掉当前代码或重写历史不能保证所有副本消失；与协作者协调，避免覆盖其他工作。

排错材料先脱敏

提供变量名、是否存在、必要错误码与堆栈即可。遮去Token、Cookie、密码、真实密钥和身份信息后再交给同事或AI，不为排查创建公开配置接口。修复后复查浏览器产物与调用，记录轮换结果。

继续看上线安全检查；本页不接收真实凭据或承诺绝对安全。

要点与资料来源

私密密钥应由服务端读取，不进入浏览器产物、仓库、日志或截图。已泄露时先吊销/轮换，再评估历史和副本清理；删除当前代码或加入gitignore不能消除历史泄露。部署时区分构建期、运行期和可公开配置，并做脱敏检查。

• gitignore 不会自动移除已经被Git跟踪的文件。
• GitHub 官方建议先吊销或轮换敏感凭据，再处理仓库历史。
• 删除历史不保证其他克隆、fork或既有缓存同步消失。
• 前端可读取的构建变量不是私密保险箱。

来源与核验范围

• GitHub：清除仓库敏感数据：2026-10-01 公开资料核对；仅支持本页明确归属的规则或功能，不代表本账号订单、独立性能测试或退款/恢复保证。

编辑：折腾鸭编辑部。2026-10-01 公开资料整理；没有替读者下单、做退款/恢复模拟或独立性能审计。