Mac版Docker Desktop更新后Docker Compose版本未更新如何解决

该问题由终端PATH环境变量的路径优先级导致：Intel芯片Mac上Docker Desktop 4.9.1默认自带的v1版docker-compose二进制路径优先级高于Homebrew安装的v2版本，终端执行命令时始终优先命中旧版文件，因此版本号显示异常。

• 先定位所有docker-compose二进制的存放路径，终端执行：

  which -a docker-compose
  

  返回结果通常包含两类路径：一类是Docker Desktop遗留的旧版文件（常见路径为/usr/local/bin/docker-compose，部分版本存放在Docker.app内部资源目录），另一类是Homebrew安装的2.6.0版本（Intel Mac下Homebrew默认安装路径软链为/usr/local/opt/docker-compose/bin/docker-compose）。
• 移除旧版本的docker-compose文件，执行以下命令（如果上一步查到的旧版路径不是/usr/local/bin/docker-compose，替换为实际查到的非Homebrew路径即可）：

  sudo rm -f /usr/local/bin/docker-compose
  

• 为Homebrew安装的新版docker-compose重建全局软链，覆盖失效的链接配置：

  brew link --overwrite docker-compose
  

• 验证版本是否生效，执行：

  docker-compose --version
  

  正常返回结果会以docker-compose version 2.6.0开头，即可正常使用适配v2规范的compose配置文件。

如果需要保留系统自带的旧版docker-compose，可以通过调整Shell的PATH优先级让终端优先读取Homebrew安装的版本：

• 如果你使用zsh（MacOS默认Shell），编辑~/.zshrc文件，在末尾添加：

  export PATH="/usr/local/opt/docker-compose/bin:$PATH"
  

• 如果你使用bash，编辑~/.bash_profile文件，添加同上的PATH配置行。
• 保存后执行对应命令让配置生效：
  • zsh用户执行：source ~/.zshrc
  • bash用户执行：source ~/.bash_profile

补充说明：Docker Desktop 4.x版本已内置Compose V2作为CLI插件，可直接通过docker compose（不带中间横杠）命令调用，无需单独安装，同样完全兼容v2版本规范的compose.yml文件。

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