Apple Silicon Mac必须安装ARM64原生Docker Desktop，否则会报“exec format error”或鲸鱼图标灰显；需确认芯片为M1/M2/M3、macOS≥12.0、uname -m返回arm64，再通过官网.dmg或Homebrew安装，并验证docker --version、hello-world及Architecture: arm64。
你在M1/M2/M3芯片的Mac上安装Docker Desktop时，若直接下载Intel版安装包，会遇到“exec format error”或启动后菜单栏鲸鱼图标灰显、不响应等故障，必须严格匹配ARM64原生版本才能正常加载内核扩展并启动守护进程。
确认芯片架构与系统版本
点击屏幕左上角苹果图标 → 选择“关于本机”，查看“芯片”字段是否明确显示“Apple M1”“M2”或“M3”；同时在终端执行 sw_vers，确认 macOS 版本 ≥ 12.0（Monterey），低于此版本将拒绝运行 Docker Desktop 4.30+。
执行 uname -m，输出必须为 【arm64】 —— 若显示 x86_64，说明你当前正通过 Rosetta 2 运行终端，需退出终端重开，或检查是否误启用了“使用Rosetta打开”选项。
方法一：官方DMG包图形化安装（推荐新手）
访问 Docker 官网下载页，页面自动识别 Apple Silicon 后显示「Download for Mac (Apple Silicon)」按钮，点击下载 Docker.dmg（约520MB，2026年11月最新版）。
双击打开下载的 Docker.dmg → 将左侧「Docker」图标拖拽至右侧「Applications」文件夹中；该操作必须完成，不能仅复制或解压到其他路径。
前往「应用程序」文件夹，右键「Docker Desktop」→「打开」；首次运行时系统弹出“已损坏，无法打开”提示，此时需立刻前往「系统设置 → 隐私与安全性 → 安全性」，在底部点击「仍要打开」——这一步跳过则后续所有权限申请将失效。
输入管理员密码授权内核扩展（com.docker.driver.amd64-linux 等）加载，勾选「使用推荐设置」，等待菜单栏鲸鱼图标由旋转状态变为【稳定常亮】（非闪烁、非灰显），通常需70–110秒。
方法二：Homebrew命令行一键部署（开发者首选）
若未安装 Homebrew，先在终端中执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
安装完成后，执行：brew install --cask --appdir=/Applications docker。该命令会自动注册内核扩展权限、配置 LaunchAgent，并将应用安装到标准/Applications路径。
安装成功后终端会输出 【docker was successfully installed!】，此时无需手动打开应用，直接执行：open -a Docker Desktop 即可启动。
注意：若此前安装过旧版Docker或lima等冲突环境，Homebrew安装前建议先运行 brew uninstall --cask docker 并清空 ~/Library/Group Containers/group.com.docker 目录，否则可能出现配置残留导致守护进程无法初始化。
验证Docker引擎是否真正就绪
第一步：等待菜单栏鲸鱼图标完全稳定常亮（至少90秒），再进行下一步。
第二步：打开新终端窗口，执行 docker --version，应返回类似 Docker version 24.0.7, build afdd... 的输出。
第三步：执行 docker run --rm hello-world，看到完整英文欢迎信息且末尾出现 This message shows that your installation appears to be working correctly. 才算真正通过验证。
第四步：检查架构兼容性，运行 docker info | grep Architecture，输出必须为 【Architecture: arm64】 —— 若显示 amd64 或 unknown，说明镜像拉取或容器运行时仍将触发 Rosetta 转译，后续所有 arm64 原生镜像（如 nginx:alpine、redis:7）将无法启动。
