macos 上用 homebrew 安装 docker 本质是安装 docker desktop 应用（含图形界面、后台服务及 cli 工具），而非纯命令行工具；需先安装并配置 homebrew，再执行 brew install --cask --appdir=/applications docker，成功后启动应用并验证 docker --version、docker info 和 docker run hello-world。

macos 上用 homebrew 安装 docker，本质是安装 docker desktop（含图形界面和后台服务），不是纯命令行工具。docker 命令行（docker、docker-compose）由 docker desktop 提供，homebrew 只负责下载、部署和管理这个应用。

确认 Homebrew 已就绪

终端中运行：

brew --version

若提示 command not found，先装 Homebrew：

• 执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• Apple Silicon（M1/M2/M3）Mac：执行 echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
• Intel Mac：执行 echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.zshrc
• 再运行 source ~/.zshrc 生效，然后 brew update

用 Homebrew 安装 Docker Desktop

这不是安装“命令行工具包”，而是安装完整 Docker Desktop 应用（含 CLI）：

PyCharm 2026.2.0.1 Mac版

PyCharm 2026.2.0.1 Mac版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合在macOS系统上进行 Python 项目开发、运行、调试和测试。

下载

• 执行：brew install --cask --appdir=/Applications docker
• 过程会自动下载 .dmg、校验、拖入 Applications、申请系统权限
• 成功后提示 docker was successfully installed!
• 首次启动需输入管理员密码，并勾选推荐设置

验证命令行是否可用

安装完成后，Docker Desktop 会在后台运行，docker 命令才真正生效：

• 打开新终端窗口（确保 shell 加载了 PATH）
• 运行 docker --version —— 应输出类似 Docker version 24.0.7
• 运行 docker info —— 若返回 JSON 信息，说明 daemon 正常运行
• 运行 docker run hello-world —— 能打印欢迎信息即完全就绪

额外：安装 docker-compose（已集成，可选单独装）

Docker Desktop 自带 docker-compose（v2+），但如需独立管理或调试：

• 执行：brew install docker-compose
• 验证：docker-compose --version
• 注意：Docker Desktop 的内置 compose 优先级更高；两者共存时，建议以 docker compose（无横线）为准