| 原则 | 镜像/包与配置分离（12-Factor 基础） |
|---|---|
| 构建期凭据 | BuildKit secret 挂载、npm/pip 私有源令牌临时注入 |
| 运行期 | 环境变量/挂载文件/密钥管理注入，变更无需重构建 |
反例与正例
反例与正例
# 反例：构建时把 API_URL 写进产物
# VITE_API_URL=https://prod.example.com npm run build
# 正例：同一产物，运行时注入（前端可通过运行时配置接口）前端构建期变量是常见例外：需要运行时配置能力（config.js/接口下发）才能保持一次构建。