docker desktop在mac上需通过“reset to factory defaults”恢复出厂设置，macos monterey 12.0+及docker desktop 4.15.0+才支持；图形界面操作最安全，可选是否删除镜像容器；界面失效时可手动删除~/library/group containers/group.com.docker等三处配置目录；验证需检查docker info中default runtime为runc且docker root dir路径正常。
Mac上Docker Desktop运行异常、配置错乱或升级后功能失效时，仅重启或重装无法清除残留的守护进程状态、网络配置和用户偏好设置，必须执行真正的“恢复出厂设置”操作才能让Docker Desktop回归初始干净状态。
确认当前Docker Desktop是否支持恢复出厂设置
macOS Monterey（12.0）及以上系统 + Docker Desktop 4.15.0 及更高版本才内置该功能。打开Docker Desktop → Settings → Resources → Reset → 查看是否有 【Reset to factory defaults】 按钮。若无此选项，说明版本过低，需先升级到最新版再继续。
通过图形界面一键恢复出厂设置
这是最安全、最推荐的方式，会自动清理所有用户级配置，但保留已下载的镜像和容器数据（不删 /var/lib/docker）。
第一步：确保Docker Desktop正在运行，且菜单栏鲸鱼图标为绿色（表示服务已启动）。
第二步：点击菜单栏鲸鱼图标 → Settings → Resources → Reset → 点击 【Reset to factory defaults】 按钮。
第三步：弹出确认窗口后，勾选 【Also remove all images, containers, volumes, and networks】（此项非默认勾选，如需彻底清空请手动勾选）→ 点击 Reset。
这一步耗时约30–90秒，期间Docker Desktop会自动退出并重建配置目录 ~/.docker，同时重置 daemon.json、证书信任链、Kubernetes配置等全部用户层设置。注意：勾选该项后，本地所有镜像、容器、卷、网络将被不可逆删除，务必提前用 docker save 或 docker export 备份关键数据。
手动删除配置目录强制重置（适用于界面按钮失效或卡死）
当Settings界面无法打开、重置按钮点击无响应或重置后仍报“failed to start”时，需绕过GUI直接清理配置文件。
关闭Docker Desktop（右键菜单栏鲸鱼图标 → Quit Docker Desktop）。
在终端中依次执行：
rm -rf ~/Library/Group\ Containers/group.com.docker ~/Library/Preferences/com.docker.docker.plist ~/Library/Saved\ Application\ State/com.docker.docker.savedState
这三处是Docker Desktop存储用户偏好、资源分配策略、窗口状态的核心路径。删掉后，下次启动会像首次安装一样重新初始化所有设置。
⚠️ 注意：不要删除 ~/Library/Application\ Support/Docker\ Desktop，该目录含证书、密钥和部分运行时缓存，误删可能导致TLS握手失败或登录态丢失。
重新打开Docker Desktop，它将自动生成全新配置，并提示你完成初始设置（包括开启Kubernetes、调整CPU内存配额等）。
验证恢复是否成功
打开终端，运行以下两条命令：
docker info | grep "Default Runtime"
docker system info | grep "Docker Root Dir"
若输出中 Default Runtime 显示为 runc（而非已被修改的 custom runtime），且 Docker Root Dir 路径未指向异常挂载点（如 /private/var/folders/xxx/T/docker-root），说明恢复成功。此时可立即运行 docker run hello-world 测试基础功能。
