推荐通过Docker Desktop一键集成安装Docker Compose，其预装Compose v2并自动适配M1/M2及Intel芯片，安装后执行docker compose version可验证成功；其他方式包括Homebrew安装、手动下载二进制、Colima替代方案及权限修复步骤。
如果您在Mac系统上需要使用Docker Compose进行多容器应用编排，但命令行中执行docker-compose或docker compose提示未找到命令，则可能是Docker Compose未安装或未正确集成。以下是多种可靠、可验证的安装方法：
一、通过Docker Desktop一键集成（推荐）
Docker Desktop for Mac已深度集成Compose v2，安装后即开即用，且自动处理ARM/x86兼容性、权限、网络等底层问题，适用于M1/M2及Intel芯片。
1、访问Docker官网下载页面，根据您的芯片类型选择对应版本：Apple Silicon（M系列）或Intel芯片版。
2、双击下载的Docker.dmg文件，将Docker.app拖入Applications文件夹完成安装。
3、首次启动时，系统将弹出权限请求窗口，务必允许网络访问、辅助功能与全盘访问权限，否则后续挂载卷或端口映射可能失败。
4、等待右上角鲸鱼图标稳定显示（状态为“Docker Desktop is running”），打开终端执行：
docker --version && docker compose version
5、若输出包含Docker Compose version v2.x.x，说明Compose v2已就绪；此时可直接使用docker compose（空格分隔）命令，旧式docker-compose命令亦被兼容层支持。
二、使用Homebrew独立安装（适用于无GUI环境或定制需求）
该方式绕过Docker Desktop，直接安装独立的docker-compose二进制文件（v1兼容模式），适合CI/CD脚本或轻量开发场景，但需手动管理Docker守护进程依赖。
1、确保已安装Homebrew：运行which brew，若无输出则先执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、更新Homebrew并安装Docker Compose：
brew update && brew install docker-compose
3、验证安装结果：
docker-compose --version
4、注意：此方式安装的是Compose v1语法兼容版本，不提供docker compose子命令；如需v2，应改用brew install docker（含完整Docker CLI套件）。
三、手动下载二进制文件（离线/指定版本/高可控性）
适用于需锁定特定版本、内网环境或规避包管理器限制的场景。该方法直接获取GitHub官方发布的预编译二进制，路径与权限需手动配置。
1、在终端中执行以下命令下载最新稳定版（以v2.24.5为例，可替换URL中版本号）：
sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
2、赋予可执行权限：
sudo chmod +x /usr/local/bin/docker-compose
3、创建符号链接以支持新旧两种调用方式（可选）：
sudo ln -sf /usr/local/bin/docker-compose /usr/local/bin/docker-compose-v2
4、关键验证步骤：执行docker-compose version后，检查输出是否含plugin字样；若显示docker-compose version 1.x，说明下载的是v1分支，请确认URL中版本前缀为v2.x.x。
四、使用Colima替代方案（无Docker Desktop依赖的轻量选择）
Colima是基于containerd的轻量级macOS容器运行时，内置Docker CLI兼容层与Compose v2支持，资源占用低，适合开发者快速启动容器化服务而无需桌面应用。
1、通过Homebrew安装Colima及配套工具：
brew install colima docker docker-compose
2、初始化并启动Colima虚拟机：
colima start --cpu 2 --memory 4 --disk 60
3、验证Docker与Compose可用性：
docker info | grep -i runtime
docker compose version
4、特别提示：Colima默认使用Linux容器运行时，Apple Silicon用户无需Rosetta转译；如需x86_64镜像支持，启动时添加--arch x86_64参数，但性能将下降约30%。
五、验证与基础权限修复
无论采用何种安装方式，若执行docker compose up报错permission denied while trying to connect to the Docker daemon socket，说明当前用户未加入docker组或守护进程未就绪。
1、确认Docker守护进程正在运行：
ps aux | grep com.docker.backend
2、检查当前用户是否在docker组中（仅对非Desktop方式有效）：
groups | grep docker
3、如未加入，执行以下命令并重启终端：
sudo dseditgroup -o edit -a $(whoami) -t user docker
4、终极检测：在任意项目目录下创建docker-compose.yml，内容为version: "3.8"，然后运行docker compose config；若返回services: {}即表示解析器正常工作。
