Windows上Docker Desktop挂载本地目录失败，是因为Docker运行于WSL2虚拟机中，无法直接访问Windows文件系统；必须先在Settings→File Sharing中授权对应盘符或路径并重启，否则路径不可见导致报错。
Windows 上的 Docker Desktop 默认不允许容器直接访问任意本地路径，必须先在设置里显式启用共享目录，否则 docker run -v C:\path\to\dir:/target 会报 error response from daemon: invalid mount config 或挂载为空。
为什么 Windows 下 -v 参数挂载本地目录会失败
Docker Desktop 在 Windows 上运行于 WSL 2 虚拟机中，它不直接访问 Windows 文件系统。宿主机路径（如 C:\Users\me\project）需先被 WSL 2 “看到”，再由 Docker Daemon 挂载进容器。未配置前，Docker 根本无法解析该路径，不是权限问题，是路径不可见。
常见错误现象包括：
-
invalid argument或failed to create shim task - 容器内目标目录存在但为空，
ls /target无任何文件 -
docker inspect显示"Source": ""或路径为/var/lib/docker/...（说明 fallback 到了匿名 volume）
必须在 Docker Desktop 设置中开启对应路径共享
打开 Docker Desktop → Settings → Resources → File Sharing，把你要挂载的 Windows 路径加进去，比如 C:\data、C:\Users\me\configs。注意：
- 路径必须以
C:\等盘符开头，不能是相对路径或环境变量（如%USERPROFILE%） - 添加后要点击
Apply & Restart，否则新路径不生效 - 如果路径含中文或空格，Docker Desktop 通常能处理，但建议优先用英文无空格路径避免边缘 case
- WSL 2 后端下，路径实际映射为
/mnt/c/data，但你写-v C:\data:/target即可，Docker 会自动转换
两个容器挂载同一本地目录的正确写法
只要宿主机目录已加入 File Sharing 列表，两个容器就可以用完全相同的 -v 参数挂载它，实现内容实时同步：
docker run -d --name app1 -v C:\data:/app/config nginx:alpine docker run -d --name app2 -v C:\data:/app/config redis:7-alpine
此时 app1 和 app2 都能读写 C:\data 下的文件，且修改立即互相可见。关键点：
- 两个
-v参数中的 Windows 路径必须完全一致（大小写不敏感，但建议统一） - 容器内挂载点路径可以不同（如一个用
/config，另一个用/etc/myapp），但源路径必须指向同一宿主机目录 - 不要混用
bind mount和named volume：比如一个写-v C:\data:/conf，另一个写-v myvol:/conf，它们不会共享数据 - 若需只读，加
:ro后缀：-v C:\data:/app/config:ro，避免容器意外覆盖配置
容易被忽略的权限和一致性细节
Windows 用户账户、WSL 2 的 UID/GID、容器内进程用户三者权限不匹配时，会出现“Permission denied”或文件创建失败，尤其在运行非 root 容器时：
- 默认情况下，WSL 2 中的 Linux 用户 UID 是 1000，若容器内程序以 UID 1001 运行，可能无法写入挂载目录
- 推荐做法：用
docker run -u 1000显式指定 UID，或在镜像中通过USER 1000固化；也可在宿主机上提前icacls C:\data /grant "Users:(OI)(CI)F"（仅开发环境） - Windows 文件系统不区分大小写，但 Linux 区分；避免在
C:\data中同时存在Config.json和config.json - 文件修改时间（mtime）在 Windows ↔ WSL 2 ↔ 容器间可能有秒级延迟，不适合强依赖纳秒级时间戳的场景
