如何让Dockerfile的COPY命令跳过Git子模块（无需.dockerignore）

方法1：精确指定要复制的内容 #

直接在COPY命令里只列出你需要的文件或目录，完全避开子模块路径就行。比如你的项目结构是：

project/
├── src/
├── config/
└── submodule_dir/  # Git子模块

就可以这么写：

COPY src/ /app/src/
COPY config/ /app/config/

缺点是如果要复制的内容太多，得挨个列出来，比较繁琐。

方法2：用COPY的--exclude参数（Docker 23.0+支持） #

从Docker 23.0版本开始，COPY命令新增了--exclude选项，能直接排除指定路径。比如：

COPY . /app/ --exclude=submodule_dir

要是有多个子模块，就加多个--exclude：

COPY . /app/ --exclude=submodule1 --exclude=submodule2

这个方法最省事，但得确保你的Docker版本够新，老版本不支持这个参数。

方法3：多阶段构建筛选内容 #

先把整个项目复制到临时镜像阶段，再把非子模块的内容复制到最终镜像里：

# 临时阶段：复制全部内容
FROM alpine AS temp_stage
COPY . /temp_project/

# 最终阶段：只复制需要的部分
FROM alpine
COPY --from=temp_stage /temp_project/src /app/src
COPY --from=temp_stage /temp_project/config /app/config
# 也可以用shell命令批量筛选：
# RUN cp -r /temp_project/!(submodule_dir) /app/

这种方法兼容性拉满，不管Docker版本高低都能用，就是步骤多了两步。

方法4：借助Git归档功能 #

构建前先用git archive把项目打包（Git归档默认不会包含子模块），再把归档文件复制到镜像里解压：

# 构建前先执行：git archive -o project.tar HEAD
COPY project.tar /app/
RUN tar -xf /app/project.tar -C /app/ && rm /app/project.tar

可以把归档命令写到构建脚本（比如Makefile、shell脚本）里，和Docker构建流程绑定在一起。

内容的提问来源于stack exchange，提问作者Intrastellar Explorer