在macOS上安装Docker通常有两种方式：使用官方提供的Docker Desktop图形化安装包，或者通过Homebrew命令行安装。两种方法最终都会安装Docker引擎和命令行客户端，但Docker Desktop额外提供了图形管理界面、Kubernetes支持和文件系统挂载优化。无论选择哪种方式，安装前都需要确认macOS版本和芯片架构，因为Apple Silicon与Intel芯片对应的安装包和虚拟化方案有所不同。
一、安装前的系统准备
安装Docker之前，先确认macOS版本是否满足要求。Docker Desktop对系统版本有明确限制，通常需要macOS 11或更高版本，较老的macOS 10.15虽然也能运行部分旧版Docker，但新版本已停止支持。建议打开关于本机查看系统版本，如果低于11，先升级系统再继续操作，否则安装过程中可能出现内核扩展加载失败或网络组件无法启动的问题。
另一个关键点是芯片架构。2020年之后的Mac大多采用Apple Silicon芯片，例如M1、M2、M3等，而更早的机型使用Intel处理器。两种架构的安装包不同，Docker Desktop官网会根据访问设备自动推荐对应版本，但手动下载时需要留意文件名中的apple或intel标识。Apple Silicon用户首次运行Docker时，系统可能提示安装Rosetta 2转译层，用于运行基于x86架构的容器镜像。如果不安装Rosetta 2，部分镜像会直接报exec format error错误。
此外，检查系统中是否安装了其他虚拟化软件。Docker Desktop在macOS上依赖Hypervisor.framework和网络内核扩展，如果VirtualBox、VMware或旧版Docker Toolbox仍然在运行，可能抢占虚拟化资源导致Docker无法启动。安装前建议退出这些软件，并确认系统偏好设置中的安全性与隐私没有阻止新的系统扩展加载。
二、使用Docker Desktop安装
Docker Desktop是最适合大多数用户的安装方式，因为它的图形界面可以直接查看容器、镜像、卷和网络状态，还集成了Docker Compose和Kubernetes。下载安装包时，直接访问Docker官网的Get Docker页面，选择Mac版本。下载完成后得到一个.dmg文件，双击打开后把Docker图标拖入应用程序文件夹即可。这个拖拽过程不会自动启动Docker，需要进入应用程序目录手动打开Docker.app。
第一次启动Docker Desktop时，macOS会弹出安全提示，要求输入管理员密码来安装特权工具和网络组件。这是正常现象，Docker需要创建/var/run/docker.sock套接字并配置虚拟网卡。输入密码后，状态栏会出现Docker的鲸鱼图标，并且图标会有一段时间处于动画状态，表示引擎正在初始化。Apple Silicon用户在这一步可能会看到Rosetta 2安装提示，点击安装即可，整个过程无需额外下载系统镜像。
等待状态栏图标变为静止的鲸鱼后，打开终端运行下面的命令检查版本。如果命令返回客户端和服务端版本信息，说明Docker引擎已经在运行。也可以运行docker run hello-world测试容器拉取和启动流程，该命令会从Docker Hub下载一个极小的测试镜像并输出欢迎信息。
docker --version docker run hello-world
三、使用Homebrew安装Docker
对于习惯命令行的开发者，Homebrew提供了一条更快捷的安装路径。前提是Mac上已经安装了Homebrew，如果还没有安装，可以在终端执行官方安装脚本。安装Docker Desktop只需要运行brew install --cask docker命令，Homebrew会自动下载最新版本的Docker Desktop安装包并放入应用程序目录。整个过程与手动下载dmg一致，但省去了访问网页和拖拽图标的步骤。
安装完成后，Homebrew不会自动启动Docker，需要手动运行open -a Docker命令，或者从启动台点击Docker图标。第一次启动同样会触发系统授权和Rosetta 2安装提示。使用Homebrew的另一个好处是后续升级方便，执行brew upgrade --cask docker就能更新到最新版本，不用到官网重新下载安装包。
# 安装Homebrew后执行 brew install --cask docker # 启动Docker Desktop open -a Docker
需要注意的是，Homebrew安装的Docker Desktop与手动下载的版本没有功能差异，所有配置文件和引擎数据都存放在~/.docker目录下。如果之前手动安装过Docker，再次使用Homebrew安装可能会提示已存在同名应用，此时可以先手动删除旧版本或者直接使用brew reinstall --cask docker覆盖安装。
四、验证安装结果与基础配置
安装完成后，除了运行hello-world，还可以通过docker info命令查看更详细的引擎状态。该命令会输出存储驱动、内核版本、容器运行时、镜像加速器地址等信息。如果输出中Server Version字段正常显示，说明Docker daemon通信正常；如果报错Cannot connect to the Docker daemon，一般是Docker Desktop没有启动或者引擎还在初始化，打开状态栏图标等待几秒即可。
国内用户经常遇到镜像拉取速度慢的问题，可以配置镜像加速器。打开Docker Desktop的设置界面，选择Docker Engine选项卡，在JSON配置中增加registry-mirrors字段。修改后需要点击Apply & Restart按钮让配置生效。下面是一个示例配置，将加速器地址替换为自己从云服务商获取的地址。
{
"registry-mirrors": [
"https://mirror.ipipp.com"
],
"experimental": false
}
Apple Silicon用户如果经常运行x86架构的镜像，建议在Docker Desktop的General设置中勾选Use Rosetta for x86/amd64 emulation on Apple Silicon。这个选项可以让基于Intel的容器通过Rosetta 2转译运行，性能比默认的QEMU模拟更好。不过某些镜像可能不兼容Rosetta，遇到启动失败时可以取消勾选改用默认模拟器。
另一个常见问题是磁盘占用持续增长。Docker Desktop默认使用一个动态增长的虚拟磁盘文件存放镜像和容器数据，时间久了可能达到几十GB。可以在Resources设置中调整Disk image size上限，或者定期运行docker system prune -a命令清理未使用的镜像、容器和网络。清理前确认没有需要保留的数据，因为该命令会删除所有未被容器引用的镜像。
五、常见问题排查与卸载
安装过程中如果遇到Docker Desktop图标反复跳动但无法启动，可以先打开活动监视器查看是否有Docker相关进程，然后强制退出并重启。若问题依然存在，需要检查系统偏好设置中的隐私与安全性，确认是否允许了Docker的系统扩展加载。有时安全软件或防火墙会拦截Docker的网络组件，可以暂时关闭第三方安全软件再试。
日志文件是排查启动问题的关键。Docker Desktop在macOS上的日志存放在~/Library/Containers/com.docker.docker/Data/log/host/目录下，使用控制台或cat命令查看最新的日志内容。日志中如果出现hypervisor或权限相关错误，通常说明虚拟化框架被占用，重启Mac能解决大部分问题。如果日志显示镜像拉取超时，则要检查网络代理和DNS设置。
如果决定彻底卸载Docker，不建议只把Docker.app拖进废纸篓，因为这样会残留大量配置文件、网络组件和虚拟磁盘。正确做法是先运行Docker Desktop自带的卸载功能，在应用程序中找到Docker.app，右键选择卸载，或者使用官方提供的卸载脚本。卸载完成后手动删除~/Library/Containers/com.docker.docker、~/Library/Group Containers/group.com.docker等目录，以及/Library/PrivilegedHelperTools下的Docker相关文件，才能完全清理干净。