忽视 .dockerignore 导致构建臃肿
许多开发者在配置 Codex 或类似平台时，容易忽略 .dockerignore 文件的重要性。默认情况下，Docker 会将整个上下文目录发送给守护进程。如果未排除 node_modules、.git 或本地环境变量文件，不仅会显著增加镜像体积，还可能引发安全漏洞。正确的做法是明确列出需要排除的非必要文件，确保只有应用代码和依赖被打包。
混淆 Git 分支与 Docker 标签策略
在工作流中，Git 的提交历史与 Docker 镜像的版本管理常出现脱节。常见的误区是将所有构建都标记为 latest，这会导致部署环境不可预测。建议采用语义化版本控制，将 Git 的 Commit Hash 或 Tag 直接映射为 Docker 镜像标签。例如，使用 git rev-parse --short HEAD 生成唯一标识，确保每次 CI/CD 流水线都能追溯到具体的代码状态，实现真正的可复现构建。
缺乏多阶段构建优化效率
单阶段构建往往导致最终镜像包含大量编译工具和调试信息，增加了启动时间和攻击面。在 Codex 等现代开发环境中，应充分利用 Docker 的多阶段构建特性。第一阶段使用包含编译器的基础镜像完成代码编译，第二阶段仅复制生成的二进制文件或静态资源到精简的基础镜像（如 Alpine 或 Distroless）。这种策略不仅能减小镜像尺寸，还能提升构建速度，是优化 Git 驱动工作流的关键步骤。