挂载后容器内看不到文件，大概率是宿主机挂载点为空或路径写反：Docker -v 为覆盖式挂载，若宿主机路径不存在则自动创建空目录，若存在但为空则容器内必为空；-v 左侧必须为真实存在的宿主机绝对路径，右侧为容器内路径，顺序颠倒会导致静默挂载错误路径。
挂载后容器内看不到文件，大概率不是权限或配置错，而是宿主机挂载点目录本身为空，或者路径写反了。
确认宿主机挂载点目录是否真实存在且非空
Docker 的 -v 是「覆盖式挂载」：容器启动时，直接把宿主机目录内容整个映射进去。如果宿主机那个路径是空的、刚 mkdir 出来的、或者压根不存在，那容器里看到的就是空目录——哪怕镜像原本自带文件，也会被覆盖掉。
- 执行
ls -la /your/host/path，确认该路径下有你期望的文件（不是空目录） - 如果目录不存在，Docker 会自动创建一个空目录，然后挂载进去；此时容器内必为空
- 如果目录存在但为空，
docker cp进去的文件也不会出现在挂载点——因为挂载已生效，docker cp只影响容器原始文件系统，不触碰挂载层
检查 -v 参数中宿主机路径和容器路径顺序是否颠倒
常见手误：-v /container/path:/host/path（错误），正确应为 -v /host/path:/container/path。Docker 不报错，但会静默创建一个名为 /container/path 的宿主机目录（如果不存在），再把它挂进容器——结果就是容器里看到的是个空目录，而宿主机上多了一个意外路径。
- 用
docker inspect 容器名 | jq '.[0].HostConfig.Binds'查看实际绑定关系（需装jq） - 或直接看
docker inspect 容器名输出中的Mounts字段，确认Source指向的是你预期的宿主机路径 - Windows/macOS 用户注意：Docker Desktop 默认只共享
C:\Users或/Users下的子目录，若挂载路径超出该范围（如C:\data），需在 Docker Desktop 设置 → Resources → File Sharing 中手动添加
验证容器内是否真的运行在挂载路径下
有些镜像（比如 OnlyOffice、n8n）会在启动时检查挂载点是否存在必要文件，若发现为空，可能跳过初始化、静默退出某服务，导致你以为“没文件”，其实是服务根本没起来。
- 进容器执行
ls -l /your/mount/path，确认目录存在且可列 - 查日志：
docker logs 容器名，重点找类似web-apps directory is empty, skipping init或no config found at /data/config.json的提示 - 某些应用要求挂载路径下必须有特定结构（如 n8n 要求
/data下有packages和workflows子目录），否则拒绝加载
Windows/macOS 上 Docker Desktop 的路径转换陷阱
Docker Desktop 在非 Linux 系统上通过虚拟机（Hyper-V / HyperKit）运行 Linux 内核，所有挂载路径都会被自动转换。路径格式错误会导致挂载失败但无显式报错。
- Windows：必须用正斜杠，且盘符要小写，例如
-v c:/data:/data（C:/data或c:\data都不行） - macOS：路径必须以
/Users/xxx开头，否则即使设置了 File Sharing，也可能挂载为空 - 符号链接（symlink）在 Docker Desktop 中默认不跟随，宿主机路径若为软链，挂载后容器内看到的是链本身，而非目标内容
最常被忽略的一点：挂载是否生效，不能只看 docker ps 是否运行，必须进容器 ls + 查 docker logs 两者结合。很多“看不到文件”的问题，本质是应用启动逻辑依赖挂载内容，而内容为空导致服务未就绪，不是文件系统挂载失败。
