ADD指令不能同步Git仓库最新状态，它仅复制构建上下文的文件快照；推荐用ARG+RUN git clone实现可控同步，或严格管理本地仓库状态配合ADD。
ADD 指令不能直接同步本地 Git 仓库的最新状态——它只在构建镜像时一次性复制文件，不会拉取远程分支、不会执行 git pull，也不感知工作区后续变更。想“同步”，关键在于理解构建时机与 Git 生命周期的关系，并配合合理策略。
明确 ADD 的行为边界
ADD（或 COPY）只是把构建上下文中的文件快照打包进镜像。即使你 ADD 一个已克隆的本地 Git 仓库目录，它复制的是你执行 docker build 命令那一刻该目录的文件状态，而非 Git 仓库的“最新提交”或“远程 HEAD”。
- 若本地仓库未 git pull，ADD 就是旧代码
- 若 .git 目录被排除在上下文外（如 .dockerignore 中写了 .git），则无法在容器内执行 git 命令
- ADD 不会触发任何 Git 操作，它不是部署工具，也不是 CI 触发器
推荐做法：用构建参数 + RUN git clone 实现可控同步
更可靠、可复现的方式是在 Dockerfile 中显式克隆——利用构建参数指定分支或 commit，让每次构建都从远程获取确定版本：
- 在 Dockerfile 开头定义参数：ARG GIT_REPO=https://github.com/user/project.git
- 在需要的位置执行：RUN git clone --branch $GIT_BRANCH --depth 1 $GIT_REPO /app && cd /app && npm install
- 构建时传参：docker build --build-arg GIT_BRANCH=main -t myapp .
这样既能保证代码新鲜，又支持分支/Tag/Commit 精确控制，还避免了本地环境差异影响构建一致性。
若坚持用 ADD，需严格管理本地仓库状态
仅适用于开发调试等非生产场景，且必须人工保障同步：
- 确保本地仓库已 git fetch && git reset --hard origin/main（或目标分支）
- 检查 .dockerignore 是否意外排除了关键文件（如 package.json、src/）
- 运行构建前执行：git status --porcelain 确认无未提交更改；否则 ADD 的是脏工作区
进阶技巧：结合多阶段构建 + 构建缓存优化
避免每次 clone 都重下整个历史，提升构建速度：
- 第一阶段用 alpine/git 镜像 clone 并 checkout 指定 commit，保留 /app 目录
- 第二阶段用生产基础镜像，COPY --from=builder /app /app
- 利用 RUN --mount=type=cache 配合 git clone（Docker 23.0+），缓存 .git/object 目录
这样既保持 Git 可追溯性，又不把完整 .git 打包进最终镜像，也利于层缓存复用。
