macOS上用Homebrew安装Docker本质是安装Docker Desktop（含图形界面与docker、docker-compose等命令行工具），需先装Homebrew，再执行brew install --cask --appdir=/Applications docker，验证docker --version及镜像加速配置。
macos 上用 homebrew 安装 docker，本质是安装 docker desktop（含完整图形界面 + 命令行工具），不是纯 cli 工具。docker desktop 自带 docker、docker-compose、docker buildx 等命令，全部可直接在终端调用，无需额外安装独立的“命令行管理工具”。
确认系统前提
确保你的 Mac 满足基本要求：
- macOS 12.6（Monterey）或更高版本（Apple Silicon 或 Intel 芯片均支持）
- 至少 4 GB 内存，推荐 8 GB 以上
- 启用虚拟化支持（默认开启，无需手动操作）
- 已安装 Xcode Command Line Tools（终端执行
xcode-select --install可快速安装）
安装 Homebrew（如未安装）
打开终端，粘贴并运行官方安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按提示完成安装后，执行 brew --version 验证是否成功。若报错权限问题，可能需先运行 sudo chown -R $(whoami) /usr/local/bin（仅限旧版 macOS 且必要时）。
用 Homebrew 安装 Docker Desktop
Homebrew Cask 已原生支持 Docker Desktop，一条命令即可完成安装：
brew install --cask --appdir=/Applications docker
该命令会自动下载最新稳定版（截至 2026 年 7 月为 v4.35+），解压并移入 /Applications，同时软链接 docker、docker-compose 等二进制文件到 /usr/local/bin，使命令全局可用。
安装完成后终端会显示 ? docker was successfully installed!。
启动并验证命令行可用性
首次使用需启动图形应用：
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 前往
/Applications，双击Docker Desktop - 输入管理员密码授权内核扩展（仅首次）
- 等待右上角出现鲸鱼图标，状态变为绿色即代表后台服务就绪
然后打开新终端窗口，运行以下命令验证：
docker --version # 输出类似：Docker version 24.0.7, build 11f1a56
docker info | head -n 5 # 查看基础运行状态（应无 permission denied 错误）
若提示 Cannot connect to the Docker daemon，说明 Docker Desktop 还未完全启动，稍等几秒再试，或点击菜单栏鲸鱼图标 → Restart。
配置镜像加速（国内用户必备）
默认拉取镜像极慢，建议配置国内镜像源（如网易、阿里云）：
- 点击菜单栏鲸鱼图标 → Settings → Daemon → Registry mirrors
- 添加一行：
https://hub-mirror.c.163.com（网易）或https://registry.cn-hangzhou.aliyuncs.com（阿里云） - 点击 Apply & Restart
重启后执行 docker info，检查输出中是否有 Registry Mirrors: 及你填写的地址，确认生效。
可选：启用 BuildKit 加速构建
提升 docker build 性能，推荐开启：
export DOCKER_BUILDKIT=1 # 永久生效可加到 ~/.zshrc： echo 'export DOCKER_BUILDKIT=1' >> ~/.zshrc source ~/.zshrc
之后所有构建将默认使用现代构建引擎，支持并发、缓存优化和更清晰的进度提示。
