不能直接迁移整个 /Users/xxx 到外置硬盘，因 macOS 多服务硬编码家目录本地性，外置盘登录阶段未就绪易致登录失败、iCloud 中断、钥匙串崩溃；软链接重定向 Documents 等子目录是最稳妥方案。
不能直接把 /Users/xxx 整体挪到外置硬盘再改系统级路径，除非你愿意承担登录失败、iCloud 同步中断、钥匙串崩溃、Time Machine 备份异常等高概率风险。macOS 在底层多个服务中硬编码了家目录的本地性假设，外置盘在登录阶段未就绪或意外拔出，就会触发权限弹窗、Finder 卡死甚至系统重启。
为什么不能直接修改 dscl . -create ~/HomeDirectory 的值
系统在登录前就通过 /var/db/dslocal/nodes/Default/users/xxx.plist 读取 home 键，该路径必须指向本地 APFS 卷上的可挂载路径。外置盘若未在登录服务启动前完成挂载（比如 USB 接口延迟、硬盘盒供电不稳、APFS 卷角色未设为 H），loginwindow 会 fallback 到空桌面或拒绝加载用户环境。即使侥幸登录成功，securityd、sharingd 和 iCloud Drive 后台进程仍可能因路径不可信而反复重置 ACL 或拒绝访问 ~/Library/Keychains。
软链接重定向 Documents/Downloads/Pictures 是最稳的方案
这个做法绕开了系统对家目录根路径的强依赖，只把大体积、低系统耦合度的子目录导出，保留 /Users/xxx 本身在内置盘上 —— 这是绝大多数 App（包括 VSCode、Chrome、Xcode）能正常工作的底线。
- 先确认外置盘已格式化为 APFS（非“区分大小写”），挂载路径如
/Volumes/ExtSSD - 退出当前账户，在另一管理员账户下执行：
mv ~/Documents /Volumes/ExtSSD/Documents<br>ln -s /Volumes/ExtSSD/Documents ~/Documents
- 同理处理
Downloads、Pictures、Movies；但不要动Desktop（13.0+ 有 Finder 渲染异常）、更不能碰Library（会导致几乎所有后台服务拒绝启动） - 重启后测试：打开终端运行
ls ~看是否显示软链接，用 Safari 下载一个文件确认写入的是外置盘而非本地盘
想彻底换家目录？必须用恢复模式 + ditto + 手动改 dscl
这不是图形界面点几下就能完成的操作。它要求你全程在恢复模式下操作，并接受后续所有系统更新、安全补丁都可能破坏外置家目录的稳定性。
- 启动进恢复模式（
Cmd+R），用diskutil apfs addVolume diskXsY APFS "ExtHome" --role=H创建专用卷（--role=H是关键，否则系统不认它是合法家目录载体） - 用
ditto -V /Users/xxx /Volumes/ExtHome/Users/xxx复制，不能用cp -R或拖拽 —— 会丢 xattr、ACL、隐藏文件权限 - 正常启动后，进“系统设置 > 用户与群组 > 高级选项”，把
Home Directory改成/Volumes/ExtHome/Users/xxx；绝对不要改 UID、Shell、Group - 首次登录大概率失败，需回到恢复模式终端，用
dscl . -read ~ HomeDirectory核对路径，再用chown -R xxx:staff /Volumes/ExtHome/Users/xxx补权限
真正难的不是复制文件，而是让系统相信那个外置盘在每次开机、每次睡眠唤醒、每次 USB 重连后，都还是同一个可信的、具备完整 macOS 家目录语义的卷。哪怕你做对了全部步骤，只要某次硬盘挂载慢了 800ms，loginwindow 就会静默降级到临时家目录 —— 你存的所有配置、SSH 密钥、Zsh 历史全都不见了。
