macOS下Docker挂载目录创建文件后执行ls命令永久挂起求助

可能原因及对应排查/修复步骤 #

1. 切换Docker文件共享协议 #

Docker Desktop在macOS上默认采用gRPC FUSE实现文件共享，部分场景下会出现文件系统操作卡住的问题，可切换回旧版osxfs协议尝试：

• 打开Docker Desktop偏好设置 → Resources → File Sharing
• 取消勾选Use the new Virtualization framework（Apple Silicon芯片设备），找到FUSE相关选项切换为osxfs
• 重启Docker后重新执行原命令测试

2. 修正目录权限匹配问题 #

本地目录权限与容器内用户权限不匹配，可能导致ls读取文件元数据时卡住：

• 在本地执行ls -ld /Users/username/myd，确认目录至少具备读权限（如drwxr-xr-x）
• 启动容器时指定与本地用户一致的UID/GID，避免权限冲突：

  # 先通过`id -u`获取本地用户UID，`id -g`获取GID
  docker run -v /Users/username/myd:/home/myd -u $(id -u):$(id -g) -it python:3 /bin/bash
  

  进入容器后再执行ls /home/myd测试

3. 排查目录内特殊文件 #

若目录中存在指向无效路径的符号链接、特殊设备文件，可能导致ls遍历目录时挂起：

• 先清空本地/Users/username/myd目录，仅保留刚创建的a.txt，重新挂载测试
• 若恢复正常，逐步添加之前的文件，定位触发问题的具体文件并移除

4. 更新或回退Docker Desktop版本 #

部分Docker Desktop版本存在文件共享模块的bug：

• 尝试更新至最新稳定版，或回退到此前能正常运行的版本（若之前无此问题）
• 更新完成后重启Docker与电脑，再验证问题是否解决

内容的提问来源于stack exchange，提问作者Che Huu