MacOS下Docker Desktop插件无效：执行docker compose命令报错求助

1. 完全重装Docker Desktop for Mac #

• 退出Docker Desktop，将应用拖入废纸篓
• 删除残留配置文件：

  rm -rf ~/Library/Application Support/Docker
  rm -rf ~/Library/Preferences/com.docker.docker.plist
  rm -rf ~/Library/Logs/Docker
  rm -rf ~/Library/Caches/com.docker.docker
  

• 下载最新稳定版Docker Desktop安装，启动后确保菜单栏显示Docker图标

2. 检查并配置PATH环境变量 #

• 执行echo $PATH，确认/usr/local/bin在输出列表中
• 若未包含，编辑shell配置文件（zsh用户编辑~/.zshrc，bash用户编辑~/.bash_profile），添加：

  export PATH="/usr/local/bin:$PATH"
  

• 执行source ~/.zshrc或source ~/.bash_profile使配置生效

3. 手动创建插件软链接 #

• 先创建插件目录（如果不存在）：

  mkdir -p ~/.docker/cli-plugins
  

• 将Docker Desktop内置的插件链接到目标目录：

  ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-buildx ~/.docker/cli-plugins/docker-buildx
  ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-compose ~/.docker/cli-plugins/docker-compose
  ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-dev ~/.docker/cli-plugins/docker-dev
  ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-extension ~/.docker/cli-plugins/docker-extension
  ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-sbom ~/.docker/cli-plugins/docker-sbom
  ln -s /Applications/Docker.app/Contents/Resources/cli-plugins/docker-scan ~/.docker/cli-plugins/docker-scan
  

4. 验证修复结果 #

• 执行以下命令确认插件正常：

  docker compose version
  docker buildx version
  

• 重新运行docker compose up --build

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