必须安装Docker Desktop官方应用，严格匹配Apple Silicon（ARM64）或Intel（x86_64）架构及macOS 12.6+系统版本；推荐用Homebrew安装，首次启动需等待60–90秒至鲸鱼图标常亮；验证须成功运行docker run hello-world；国内用户务必配置registry-mirrors镜像加速。
要在Mac上运行Docker容器，必须先安装Docker Desktop官方应用，它集成了引擎、CLI和图形界面，不能仅靠命令行工具替代；Apple Silicon（M1/M2/M3）和Intel芯片需严格匹配对应架构版本，装错会导致应用无法启动或报“exec format error”。
确认芯片类型与系统版本
这一步不可跳过，否则后续下载的安装包大概率无法运行。点击左上角苹果图标 →「关于本机」，查看「芯片」字段：若显示Apple M1/M2/M3，即为ARM64架构；若显示Intel Core i5/i7等，则为x86_64架构。
同时在终端执行sw_vers，确认macOS版本不低于12.6（Monterey）——Apple Silicon机型强制要求此版本及以上，低于该版本将直接拒绝启动Docker Desktop。
若系统版本过低，请先升级macOS再继续；混用芯片架构与系统版本组合，安装过程不会报错，但首次启动时鲸鱼图标会卡在旋转状态并静默退出。
通过Homebrew一键安装（推荐开发者）
方法一：已装Homebrew
终端中直接执行：brew install --cask --appdir=/Applications docker
方法二：未装Homebrew
先运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，安装完成后立即执行上述docker安装命令。
安装成功后终端会输出docker was successfully installed!，此时Docker Desktop已注册为系统服务，无需手动拖拽或重复授权；执行open -a Docker即可启动，菜单栏出现鲸鱼图标即表示加载中。
【首次启动需等待60–90秒，图标由旋转变为常亮才算引擎就绪】
通过.dmg包手动安装（适合图形界面偏好者）
第一步：访问https://www.docker.com/products/docker-desktop/，页面自动识别芯片类型后点击「Download for Mac (Apple Silicon)」或「Download for Mac (Intel chip)」。
第二步：双击下载的Docker.dmg，将左侧Docker图标拖入右侧「应用程序」文件夹。
第三步：前往「应用程序」→右键「Docker Desktop」→「打开」；若弹出“已损坏，无法打开”，需去「系统设置 → 隐私与安全性 → 安全性」中点击「仍要打开」。
第四步：首次运行时输入管理员密码，勾选「使用推荐设置」，点击继续——这一步会自动加载内核扩展并配置网络代理，跳过将导致后续docker run命令报Cannot connect to the Docker daemon错误。
验证Docker是否真正可用
① 等待右上角鲸鱼图标变为稳定常亮（非旋转、非灰显），通常需1–2分钟。
② 打开终端，执行：docker --version，应返回类似Docker version 24.0.7, build afdd的输出。
③ 执行：docker run hello-world，终端打印出包含“Hello from Docker!”的多段文本，且末尾有“Your kernel is supported”字样，即代表镜像拉取、容器创建、标准输出全流程通路已打通。
注意：仅图标出现或docker --version有输出，不代表容器能跑；必须完成第③步才能确认Docker引擎完全就绪。
配置国内镜像加速器（国内用户必做）
点击右上角鲸鱼图标 → Settings → 左侧选择「Docker Engine」。
在右侧JSON编辑框中，插入或修改"registry-mirrors"字段，填入至少一个国内镜像地址，例如："https://r6hv888q.mirror.aliyuncs.com"。
点击「Apply & Restart」，等待Docker Desktop重启完成——不配置该选项，拉取nginx、redis等常用镜像时大概率卡在Pulling fs layer并超时失败。
