需先确认macOS版本≥10.15且芯片架构（Apple Silicon/Intel）匹配安装包；推荐Homebrew命令行安装，亦可选官方.dmg或Lima轻量方案；安装后须CLI验证服务就绪，并配置国内镜像加速器及ARM下x86容器兼容性。
一、确认系统与芯片架构兼容性
安装前必须验证macOS版本及处理器类型，避免因架构不匹配导致Docker Desktop无法启动或静默失败。Apple Silicon（M1/M2/M3）与Intel芯片需对应不同安装包，且系统版本低于10.15（Catalina）将直接拒绝运行。
1、点击左上角苹果图标 → 选择“关于本机”。
2、查看“芯片”或“处理器”字段：若显示“Apple M1”“M2”“M3”，则为arm64架构；若显示“Intel Core i5”“i7”等，则为x86_64架构。
3、打开终端执行：sw_vers，确认macOS版本不低于10.15；推荐使用macOS 12（Monterey）及以上版本以支持完整功能。
二、通过Homebrew命令行安装（推荐）
该方式实现自动化依赖管理与后续一键升级，规避图形界面拖拽操作及重复权限授权，适合开发者长期维护本地开发环境，尤其适配CI/CD流程集成。
1、若未安装Homebrew，在终端中执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、安装完成后，执行：brew install --cask --appdir=/Applications docker。
3、等待终端输出docker was successfully installed!提示。
4、执行：docker --version，应返回类似Docker version 24.0.7的输出。
三、通过官方.dmg包手动安装
适用于未部署Homebrew或偏好图形化流程的用户，安装包内含完整Docker Desktop应用、内核扩展组件及图形界面，无需额外依赖配置。
1、访问https://docs.docker.com/desktop/install/mac-install/，根据芯片类型选择对应版本：Mac with Apple chip（ARM64）或Mac with Intel chip（x86_64）。
2、双击下载的.dmg文件，将Docker图标拖入“Applications”文件夹。
3、前往“Applications”文件夹，双击“Docker Desktop”启动应用。
4、首次运行时，系统弹出权限请求，输入管理员密码并勾选使用推荐设置，点击继续。
四、通过Lima轻量级虚拟机安装（进阶替代方案）
针对厌恶Docker Desktop资源占用高、UI卡顿、频繁崩溃等问题的开发者，Lima基于QEMU提供无GUI、CLI原生兼容的Docker运行时，支持arm64/x86_64双架构切换与精细资源控制，适用于M系列芯片深度定制场景。
1、在终端中执行：brew install lima。
2、初始化Docker专用Lima实例：limactl start template://docker。
3、等待实例启动完成，执行：lima sudo systemctl start docker启用守护进程。
4、配置本地CLI指向Lima实例：export DOCKER_HOST=unix://$HOME/lima/docker/sock/docker.sock。
5、验证：docker --version与docker run hello-world应正常响应。
五、验证Docker服务是否就绪
仅菜单栏出现鲸鱼图标不代表引擎已启动成功；必须通过CLI确认守护进程响应能力，否则后续所有容器操作均会失败，包括镜像拉取、容器创建与端口映射。
1、等待右上角菜单栏小鲸鱼图标状态变为稳定常亮（非旋转或灰显）。
2、打开终端，执行：docker --version，确认版本信息正常输出。
3、执行：docker run hello-world，若终端打印包含Hello from Docker!的多段文本，则表明镜像拉取、容器创建、标准输出均正常。
六、配置国内镜像加速器（国内用户必做）
因Docker Hub官方源位于境外，未配置加速器时镜像拉取常超时失败或卡在Pulling fs layer阶段，严重影响开发效率；单源失效将导致全部拉取中断，故需至少配置两个可用镜像地址。
1、点击右上角鲸鱼图标 → Settings → 左侧选择Docker Engine。
2、在右侧JSON编辑框中，插入或修改"registry-mirrors"字段，填入至少两个国内可用镜像地址，例如："https://hub-mirror.c.163.com", "https://docker.mirrors.ustc.edu.cn"。
3、点击Apply & Restart，等待Docker Desktop自动重启并加载新配置。
4、执行：docker info | grep -A 10 "Registry Mirrors"，确认输出中包含已配置的镜像地址。
七、ARM架构下x86容器兼容性配置
Apple Silicon芯片原生运行arm64镜像，但部分遗留系统或闭源工具仅提供x86_64镜像；需启用Rosetta 2转译支持，否则docker run将报错“exec format error”。
1、创建专用Rosetta上下文：docker context create rosetta --docker "host=unix:///var/run/docker.sock"。
2、切换至该上下文：docker context use rosetta。
3、运行x86_64镜像时显式指定平台：docker run --platform linux/amd64 ubuntu:22.04 uname -m，应输出x86_64。
4、如需全局默认启用x86_64模拟，可在Docker Engine JSON配置中添加："experimental": true, "builder": {"gc": {"defaultKeepStorage": "20GB"}}并重启。
