新卷为什么自带文件
具名卷第一次挂载到一个在镜像里已有内容的目录时，Docker 会把该目录的内容复制进空卷，这样镜像自带的数据（初始化脚本、默认配置、初始数据文件）能自动进入新卷，省去手工初始化。两个前提要记住：卷必须是空的，目标目录在镜像里必须有内容。已经装过数据的卷不会被覆盖，绑定挂载则完全不复制。
基本信息
| 触发条件 | 空卷 + 镜像内目标目录有内容 |
|---|---|
| 不触发 | 卷已有数据；绑定挂载一律不复制 |
| 复制方向 | 镜像目录 → 卷，仅在首次挂载时发生 |
| 代价 | 镜像目录内容多时会拖慢首次启动 |
典型使用场景
- 数据库首次初始化：镜像里的初始化脚本与配置自动进入新卷
- 依赖默认配置：应用自带默认配置文件，新卷挂载后无需手工拷贝
- 理解数据消失：换成绑定挂载后目录变空，是因为这层复制不生效
- 准备空目录：绑定挂载前先在宿主目录里准备必要文件而不是等自动复制
- 控制启动时间：镜像目录很大时，首次挂载的复制会成为启动耗时的主要来源
观察初始化行为
观察初始化行为
# 第一次运行：空卷挂到有内容的目录，内容被复制进卷
docker run -d --name pg -v pgdata:/var/lib/postgresql/data postgres:16-alpine
# 用临时容器查看卷里已经初始化好的内容
docker run --rm -v pgdata:/data alpine ls /data | head
# 换成绑定挂载对比：宿主空目录不会被填充
docker run --rm -v "$PWD/emptydir:/data" alpine ls /data
# 核对卷的挂载点与创建时间
docker volume inspect pgdata挂载类型与首次行为
| 挂载类型 | 首次挂载行为 | 结果 |
|---|---|---|
| 空具名卷 | 复制镜像目录内容进卷 | 卷里能看到初始文件 |
| 已有数据的卷 | 不复制，保留卷内数据 | 镜像里的新文件不会出现 |
| 绑定挂载 | 不复制 | 宿主目录为空则容器内也为空 |
| 匿名卷 | 与具名卷行为一致 | 随容器创建自动产生 |
初始化的复制只发生在第一次挂载空卷时，之后镜像里新增的文件不会自动同步到已有卷里。
应用启动时发现目录非空可能跳过初始化，这种判断逻辑会让「复制过一次」的卷再也拿不到新版本镜像里的初始化内容。