推荐通过Homebrew安装Docker Desktop:先装Homebrew,再执行brew install --cask --appdir=/Applications docker,验证docker --version及docker run hello-world成功,并配置国内镜像加速器提升拉取效率。

如果您希望在Mac本地快速搭建Docker容器开发环境,但尚未安装或配置Docker Desktop,则可能是由于安装方式选择不当、芯片架构适配错误或缺少必要网络加速配置所致。以下是完成安装与基础配置的多种可行路径:
一、通过Homebrew命令行安装(推荐)
该方式支持自动化依赖管理与后续一键升级,避免图形界面拖拽和重复权限授权,适合开发者长期维护本地开发环境。
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/下载最新.dmg文件
2、双击打开下载的文件,将Docker图标拖入“Applications”文件夹
3、前往“Applications”文件夹,双击“Docker Desktop”启动应用
4、首次运行时,系统弹出权限请求,输入管理员密码并勾选使用推荐设置,点击继续
三、验证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"
3、点击Apply & Restart使配置生效










