构建Docker镜像时如何将当前目录及子目录复制到镜像中？

我来帮你排查这个问题，你遇到的报错本质上是两个常见的Dockerfile写法误区导致的，咱们一步步来解决：

为什么原来的命令会失败？ #

你的命令ADD ./* $HOME/src有两个核心问题：

1. Shell变量解析问题：Dockerfile里的ADD/COPY命令不会自动解析shell环境变量（比如$HOME），它会把$HOME当成字面路径的一部分，也就是实际尝试把文件复制到$HOME/src这个不存在的路径，而不是你期望的/root/src。
2. 目录不存在时的行为：就算$HOME能被解析，如果$HOME/src目录不存在，ADD ./*不会自动创建这个目录——它会把第一个匹配到的文件直接命名为src（作为文件而非目录），后续RUN ls $HOME/src自然找不到这个目录。

正确的实现方式 #

这里给你两种可靠的写法，选哪种都可以：

写法一：使用绝对路径（最稳妥） #

直接用明确的绝对路径避免变量解析问题，同时先确保目标目录存在：

# 替换成你的基础镜像，比如ubuntu、alpine等
FROM ubuntu:latest

# 先创建目标目录，-p参数确保父目录不存在时也能创建
RUN mkdir -p /root/src

# 复制当前目录所有文件（包括隐藏文件）到目标目录
COPY . /root/src

# 验证文件是否复制成功
RUN ls /root/src

写法二：定义ENV变量后使用 #

如果你偏好用$HOME，可以先在Dockerfile里用ENV定义这个变量，这样ADD/COPY就能正确解析它了：

FROM ubuntu:latest

# 定义HOME变量，对应root用户的家目录
ENV HOME /root

# 创建目标目录
RUN mkdir -p $HOME/src

# 复制文件到目标目录
COPY . $HOME/src

# 验证
RUN ls $HOME/src

额外小提示 #

• 优先用COPY而非ADD：COPY专门用于本地文件复制，语义更清晰；ADD除了复制还会自动解压压缩包，如果你不需要这个功能，COPY更合适。
• 用.代替./*：./*只会复制当前目录下的非隐藏文件，而.会复制所有文件（包括.gitignore、.env这类隐藏文件），更符合你"复制所有文件及子目录"的需求。

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