Docker Desktop挂载暴露宿主机文件系统大小写差异：macOS/Windows不区分大小写，Linux容器严格区分，导致同名文件在跨平台挂载时被识别为不同文件或引发覆盖、缺失等故障。
直接说结论：Docker Desktop 本身不改文件名大小写，但挂载行为会暴露宿主机文件系统的大小写敏感性差异——你在 macOS 或 Windows 上看到的 File.jpg 和 file.jpg 可能是同一个文件，一旦挂进 Linux 容器（或推到 Linux 服务器），它们就变成两个独立文件，甚至引发“找不到资源”“覆盖静默失败”等真实故障。
为什么 Docker Desktop 挂载后文件大小写突然“出问题”
这不是 Docker 的 bug，而是跨平台文件系统语义不一致导致的必然结果：
- macOS（APFS 默认）和 Windows（NTFS）对文件名不区分大小写，但保留原始大小写。你重命名
IMG.JPG→img.jpg，系统可能根本没执行底层 rename，只是刷新了显示 - Docker Desktop 底层用的是 WSL2（Linux 内核），它严格区分大小写。容器内执行
ls /data/img.jpg找不到，但ls /data/IMG.JPG能列出，说明宿主机上这两个名字确实同时存在（或曾存在） - 更隐蔽的是“挂载时路径拼写错位”：比如宿主机路径是
/Users/me/Project/Assets，你写成/users/me/project/assets（小写开头），在 macOS 上能挂载成功（不敏感），但在容器里就是空目录
检查挂载目录中真实存在的文件名大小写
别信 Finder 或资源管理器的显示，进容器看真实视图：
- 先确认挂载是否生效：
docker exec -it your-container ls -la /mounted/path - 重点看输出里的原始文件名——注意大小写、点号位置、空格。比如看到
-rw-r--r-- 1 root root 12345 Jan 1 10:00 logo.PNG，而代码里写的是logo.png，这就是典型问题 - 对比宿主机对应路径的真实内容：
ls -la /absolute/host/path（必须用绝对路径）。如果宿主机输出里同时有config.json和CONFIG.JSON，说明已有冲突隐患 - 用
find /absolute/host/path -maxdepth 1 -iname "config.json" -print查所有大小写变体，避免漏掉
批量统一为小写：安全落地的三步操作法
别直接 rename，先预览、再原子替换、最后验证容器内行为：
- macOS：用
zsh+mv安全重命名（需开启extendedglob）setopt extendedglob for f (**/*); do [[ -f "$f" ]] && mv "$f" "${f:l}" done注意：该命令只处理文件，不碰目录；${f:l}是 zsh 内置小写转换，比调外部tr更可靠 - Linux / WSL2：推荐用
rename工具（非 BusyBox 版）rename 's/(.*)\/([^\/]*)/$1\/\L$2/' **/* 2>/dev/null || true
加2>/dev/null || true是为了跳过权限错误，避免中断 - Windows（PowerShell）：慎用
Get-ChildItem+Rename-Item，必须加-LiteralPath防止通配符误匹配中文或特殊字符Get-ChildItem -Path "C:\data" -Recurse -File | ForEach-Object { $newName = $_.Name.ToLower() if ($_.Name -ne $newName) { Rename-Item -LiteralPath $_.FullName -NewName $newName -ErrorAction SilentlyContinue } }
挂载前必须做的一件事：验证路径是否存在且大小写精确匹配
这是 90% 的“挂载后为空”问题的根源——Docker 不报错，但也不挂载：
- 运行
ls -d /your/host/mount/path，如果报No such file or directory，立刻mkdir -p /your/host/mount/path - 路径中的每一级都必须大小写完全一致。比如宿主机实际路径是
/Users/Me/Project/Data，你写/users/me/project/data，在 macOS 上能挂上，但容器内ls /mnt是空的 - 用
readlink -f /your/host/mount/path获取真实解析路径，复制粘贴进docker run -v参数，杜绝手误 - 如果你用
docker-compose.yml，绝对不要写./data这类相对路径——它在不同 shell 环境下解析结果不同，强制用${PWD}/data或完整绝对路径
最常被忽略的点是：你以为在 macOS 上“改完了大小写”，其实只是 Finder 刷新了显示；真正要生效，得让文件系统底层产生一次 rename 系统调用。所以无论用什么工具，执行完后务必进容器跑一遍 ls -la，并用 stat 看 inode 是否变化——这才是唯一可信的验证方式。
