目录无法遍历主因是归属错误、ACL异常、扩展属性干扰或权限位缺失rx，需按“锁定状态→共享权限→用户组→ls -ld检查→diskutil重置→手动chown/chmod/xattr清理”分层修复。

目录无法正常遍历（比如访达点不开“家”、终端执行 cd ~ 报错、桌面空白、ls -la 显示权限异常）通常不是文件丢失，而是系统认不出这个目录属于你——根源集中在归属（owner）、acl（访问控制列表）、扩展属性（如 quarantine）或基础权限位错乱。修复需分层定位、按序干预。

先确认是不是真权限问题

别急着敲命令，先快速排除常见干扰：

• 右键该目录 → “显示简介” → 检查是否勾选了「锁定」；如有，取消勾选
• 在“共享与权限”区域，确认你的用户名存在且权限是「读与写」；若为「无法访问」或空缺，点锁图标输密码后添加并设权
• 终端运行 id -Gn，输出里必须同时含 admin 和 wheel；缺一说明账户权限组不完整
• 执行 ls -ld /path/to/dir，重点看三列：所有者是否为你的用户名、权限位是否含 r 和 x（如 drwx------ 正常，d------x 或 dr-xr-xr-x 就有问题）

用户主目录（/Users/xxx）权限损坏的首选修复

这是最常见也最严重的遍历失败场景，尤其出现在迁移、Time Machine 恢复或系统重装后。官方推荐用 diskutil resetUserPermissions 一键重置，它会还原标准 ACL、继承规则、归属和关键扩展属性：

• 用另一个管理员账户登录（不能用自己的问题账户）
• 终端执行 id -u yourusername（把 yourusername 换成你的用户名），记下输出的数字（如 501）
• 执行 sudo diskutil resetUserPermissions / 501（替换为你查到的 UID）
• 命令无进度条，返回提示符即完成；重启后测试访达“家”、终端 cd ~、打开钥匙串等核心功能

手动补救：当一键命令失败或需深度干预时

如果 resetUserPermissions 报错（如 “no such user” 或 “operation not permitted”），说明用户记录或底层元数据已异常，需分步清理：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 清除不可更改标志：sudo chflags -R nouchg /Users/yourusername
• 重置全部归属：sudo chown -R yourusername:staff /Users/yourusername
• 设严格基础权限：sudo chmod 700 /Users/yourusername（注意：必须是 700，不可放宽）
• 清理干扰扩展属性：xattr -rc /Users/yourusername（移除 quarantine、FinderInfo 等冗余标记）
• 重置 ACL（macOS 12+ 常需）：chmod -N /Users/yourusername && chmod +a "group:everyone deny delete" /Users/yourusername

普通子目录（如 Desktop、Documents）快速修复

若只是某个子目录（非整个家目录）遍历异常，优先图形界面操作，安全又直观：

• 在访达中选中该文件夹（如 ~/Desktop），按 Cmd + I 打开“简介”
• 拉到底部，点开“共享与权限”三角箭头；如看不到，先点旁边小箭头展开
• 点锁图标，输入管理员密码解锁
• 找到你的用户名，右侧下拉选「读与写」；再点齿轮图标 → 「应用到包含的项目」
• 若图形界面无法识别你（用户名灰显或缺失），再切终端执行：sudo chown -R $USER:staff ~/Desktop && sudo chmod -R 755 ~/Desktop