macOS Catalina系统通过brew安装Docker两次均报错如何解决

问题原因分析 #

1. 第一种formula安装方式报错原因 #

brew默认的docker formula仅包含Docker命令行客户端，不包含运行容器必需的Docker后台守护进程（Daemon），因此执行镜像拉取等操作时会提示无法连接daemon。

2. 第二种cask安装方式报错原因 #

brew安装Docker Desktop cask后仅完成了应用本体的放置，Docker命令行工具的路径配置需要首次启动Docker Desktop完成初始化才会生效，也有可能是当前shell未刷新PATH配置导致无法识别命令。 #

解决步骤 #

• 先完全卸载残留的docker相关组件，避免版本冲突：

brew uninstall docker
brew uninstall --cask docker
rm -rf ~/.docker

• 重新安装Docker Desktop cask：

brew install --cask docker

• 从启动台或/Applications目录打开Docker.app，按照提示完成初始化操作（同意用户协议、输入系统权限密码），等待Docker Desktop状态栏图标提示启动完成
• 刷新当前zsh配置让PATH生效：

source ~/.zshrc
# 如果仍提示找不到命令，手动添加Docker命令路径到zsh配置
echo 'export PATH="$PATH:/Applications/Docker.app/Contents/Resources/bin/"' >> ~/.zshrc
source ~/.zshrc

• 验证安装是否成功：

docker --version
docker run hello-world

内容的提问来源于stack exchange，提问作者Aniket Tiwari