必须显式声明 external: true 且卷名完全匹配已存在卷，否则 Docker Compose 会新建同名卷；不能配置 driver 或 driver_opts，需通过 docker volume inspect 验证卷是否存在。
直接用 external: true 声明即可，但必须确保卷名、驱动、挂载参数完全匹配已存在卷的元数据，否则 docker compose up 会报错或静默创建新卷。
怎么在 docker-compose.yml 中引用已存在的命名卷
Compose 不会自动发现宿主机上已有的命名卷，必须显式声明并标记为外部。关键点不是“接入”，而是“不创建、只引用”。
-
volumes顶层块中定义的卷名必须与docker volume ls输出的 NAME 完全一致（含项目前缀，如果有的话） - 必须设置
external: true，否则 Compose 会在启动时尝试创建同名卷，导致冲突 - 不能写
driver_opts或driver—— 这些信息由已有卷决定，Compose 不允许覆盖 - 示例配置：
version: '3.8'
services:
db:
image: postgres:15
volumes:
- db_data:/var/lib/postgresql/data
<p>volumes:
db_data:
external: true</p>
注意：这里 db_data 必须是已经通过 docker volume create db_data 或其他方式创建好的卷；若用 docker volume create --driver local --opt type=none --opt o=bind --opt device=/mnt/data/db db_data 创建过绑定挂载卷，那它就不是纯 local 卷，而是一个带 driver_opts 的本地卷 —— 此时上面的 external: true 配置仍可用，但不能在 volumes 块里再加 driver_opts，否则报错。
为什么 docker compose up 有时会新建一个同名卷而不是用已有的
常见于两种情况：卷名拼写不一致（比如大小写、下划线/中划线混淆），或未设 external: true。
- Compose 默认行为是“如果卷不存在就创建”，即使你写了同名卷但没标
external: true，它就会新建一个空卷 - Windows 上尤其容易因路径大小写敏感性误判 ——
DB_DATA和db_data在 Windows 文件系统里可能被当成同一个目录，但在 Docker 卷命名中是两个不同卷 - 如果你用的是 Docker Desktop + WSL2，还要确认该卷是在 WSL2 的 Docker daemon 下创建的，而不是 Windows 原生 Docker（已弃用）或 Hyper-V 后端
- 验证方式：在 PowerShell 或 WSL2 终端里运行
docker volume inspect db_data，看输出是否包含"CreatedAt"和真实数据路径；如果报 “no such volume”，说明名字对不上
绑定挂载（bind mount）能不能算作“外部数据卷”被 Compose 复用
可以，但不是通过 volumes 顶层声明，而是直接在 service 的 volumes 列表里写绝对路径。
- 绑定挂载本质就是宿主机路径映射，不需要提前创建卷，也无所谓“外部/内部”之分
- 例如：
- /c/Users/me/app-data:/app/data（Windows）或- /home/user/app-data:/app/data（Linux/macOS） - 这种写法绕过了命名卷机制，适合开发调试或明确要复用某固定目录的场景
- 但要注意：Windows 路径必须用
/c/...格式，不能用C:\...；且该路径需在 Docker Desktop 的 Resources → File Sharing 设置中已勾选授权 - 和命名卷相比，绑定挂载没有卷生命周期管理，删容器不会影响宿主机目录，但也无法被多个服务以卷名方式共享
最易忽略的一点：Docker Desktop 的卷元数据存储在 WSL2 实例内部（默认 distro 是 docker-desktop-data），不是 Windows 文件系统直存。所以你在 Windows 资源管理器里看不到 docker volume 对应的真实目录，也不能手动删里面的文件 —— 必须用 docker volume rm 或进 WSL2 手动清理 /var/lib/docker/volumes/ 下对应子目录。否则你以为“清空了数据”，其实只是删了软链接或缓存。
