根据您的问题，`docker-compose` 命令未找到，这表明 Docker Compose 没有正确安装或未配置到系统的 PATH 环境变量中。Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具，您需要先安装它才能使用 `docker-compose` 命令。 ### 一、问题原因分析 在 macOS 上，`zsh: command not found: docker-compose` 错误通常由以下原因导致： | 可能原因 | 说明 | | :--- | :--- | | **1. Docker Compose 未安装** | Docker Desktop for Mac 默认包含 Docker Compose，但如果是手动安装 Docker Engine，可能需要单独安装 Docker Compose。 | | **2. PATH 环境变量未包含 Docker Compose** | Docker Compose 的安装路径没有添加到 `zsh` shell 的 PATH 环境变量中，导致系统无法找到该命令。 | | **3. Docker Compose 安装不完整或损坏** | 安装过程中出现错误，或文件权限问题导致可执行文件无法正常运行。 | | **4. 使用了过时的安装方法** | 使用 `pip` 或 `curl` 安装的旧版本 Docker Compose 可能与当前 Docker 版本不兼容，或安装路径不一致。 | ### 二、解决方案：安装与配置 Docker Compose 以下是针对 macOS 系统的详细安装与配置步骤。 #### **方案A：通过 Docker Desktop 安装（推荐）** Docker Desktop for Mac 是安装 Docker 及其相关工具（包括 Docker Compose）的最简单方法，它会自动处理所有路径配置[ref_5]。 1. **下载并安装 Docker Desktop** * 访问 [Docker 官网](https://www.docker.com/products/docker-desktop/) 下载适用于您的 Mac（Apple Silicon 或 Intel 版本）的 Docker Desktop 安装包[ref_1]。 * 双击下载的 `.dmg` 文件，将 Docker 图标拖拽到“应用程序”文件夹中。 * 打开“应用程序”文件夹，双击 Docker.app 启动 Docker Desktop。 * 按照初始设置向导完成安装（通常需要输入系统密码以授权安装网络组件）。 2. **验证安装** 安装完成后，打开终端（Terminal）并运行以下命令来验证 Docker 和 Docker Compose 是否安装成功： ```bash # 验证 Docker 客户端 docker --version # 输出示例：Docker version 26.0.0, build 2ae903e # 验证 Docker Compose（V2 版本，作为 Docker CLI 插件） docker compose version # 输出示例：Docker Compose version v2.26.0 # 注意：Docker Desktop 默认安装的是 Docker Compose V2，命令是 `docker compose`（中间没有横杠） # 但通常也会设置一个 `docker-compose`（带横杠）的兼容性符号链接 docker-compose --version # 输出示例：Docker Compose version v2.26.0 ``` 如果 `docker compose version` 命令成功执行，但 `docker-compose` 命令仍然报错，请参考**方案C**配置 PATH。 #### **方案B：手动安装 Docker Compose（如果已安装 Docker Engine）** 如果您已经通过其他方式（如 Homebrew）安装了 Docker Engine，但没有 Docker Compose，可以手动安装。 1. **使用 Homebrew 安装** Homebrew 是 macOS 上常用的包管理器，可以简化安装过程[ref_5]。 ```bash # 1. 确保 Homebrew 已安装并更新 brew update # 2. 安装 Docker Compose brew install docker-compose # 3. 验证安装 docker-compose --version ``` 2. **使用 curl 下载二进制文件（官方方法）** 这是 Docker 官方推荐的独立安装方法[ref_4]。 ```bash # 1. 下载 Docker Compose 的二进制文件到 /usr/local/bin/docker-compose # 注意：请从 Docker 官方 GitHub Releases 页面查看最新版本号替换下面的 `v2.26.0` sudo curl -L "https://github.com/docker/compose/releases/download/v2.26.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose # 2. 授予二进制文件可执行权限 sudo chmod +x /usr/local/bin/docker-compose # 3. 验证安装 docker-compose --version ``` #### **方案C：配置 PATH 环境变量（如果命令已安装但未找到）** 如果 Docker Compose 已安装但系统仍提示未找到，可能是因为其安装目录不在 `zsh` 的 PATH 变量中。 1. **查找 Docker Compose 的安装位置** ```bash # 使用 which 或 find 命令查找 sudo find /usr -name "docker-compose" 2>/dev/null # 或 ls -la /usr/local/bin/docker-compose ``` 常见的安装路径包括： * `/usr/local/bin/docker-compose`（Homebrew 或手动 curl 安装） * `$HOME/.docker/cli-plugins/docker-compose`（Docker Desktop 的插件位置） * `/Applications/Docker.app/Contents/Resources/bin/docker-compose`（Docker Desktop 内部路径） 2. **将路径添加到 `zsh` 的 PATH 中** 编辑 `zsh` 的配置文件 `~/.zshrc`： ```bash # 使用 nano 或 vim 编辑器 nano ~/.zshrc ``` 在文件末尾添加以下行（假设您的安装路径是 `/usr/local/bin`）： ```bash # 将 Docker Compose 路径添加到 PATH export PATH="/usr/local/bin:$PATH" # 如果是 Docker Desktop 的插件路径，可能需要添加 export PATH="$HOME/.docker/cli-plugins:$PATH" ``` 保存文件（在 nano 中按 `Ctrl+O`，然后按 `Enter`，再按 `Ctrl+X` 退出）。 3. **使配置生效** ```bash # 重新加载 ~/.zshrc 配置文件 source ~/.zshrc # 或重新打开终端 ``` 4. **再次验证** ```bash docker-compose --version ``` ### 三、安装后的基本使用 安装成功后，您就可以使用 `docker-compose` 命令来管理您的多容器应用了[ref_3]。 1. **创建一个 `docker-compose.yml` 文件** 在您的项目目录中，创建一个 `docker-compose.yml` 文件来定义服务。例如，一个简单的 Web 应用和数据库组合： ```yaml version: '3.8' # 指定 Compose 文件版本 [ref_3] services: web: image: nginx:alpine ports: - "8080:80" # 将宿主机8080端口映射到容器的80端口 volumes: - ./html:/usr/share/nginx/html # 挂载本地目录 db: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: example MYSQL_DATABASE: myapp volumes: - db_data:/var/lib/mysql volumes: db_data: # 定义命名卷用于数据持久化 ``` 2. **启动服务** 在包含 `docker-compose.yml` 文件的目录中运行： ```bash # 启动服务并在后台运行 (-d 表示分离模式) docker-compose up -d ``` 这将根据配置拉取镜像（如果本地没有）并启动容器。 3. **查看服务状态** ```bash # 查看当前项目运行中的容器 docker-compose ps # 查看所有容器（包括已停止的） docker-compose ps -a ``` 4. **查看服务日志** ```bash # 查看所有服务的日志 docker-compose logs # 查看特定服务（如 web）的日志，并实时跟踪 docker-compose logs -f web ``` 5. **停止和清理服务** ```bash # 停止正在运行的服务 docker-compose down # 停止服务并移除所有相关的数据卷（谨慎操作，会删除数据！） docker-compose down -v ``` ### 四、故障排查与进阶提示 * **权限问题**：如果遇到权限错误，确保您有 `/usr/local/bin` 目录的写入权限，或将 Docker Compose 安装在用户目录下并正确配置 PATH。 * **版本兼容性**：确保您的 `docker-compose.yml` 文件版本与安装的 Docker Compose 版本兼容。可以使用 `docker-compose version` 查看版本，并在文件顶部用 `version` 字段指定兼容的版本[ref_3]。 * **命令别名**：Docker Compose V2 作为 Docker CLI 插件，主要命令是 `docker compose`。如果您习惯使用带横杠的命令，Docker Desktop 通常会设置一个符号链接。如果没有，您可以手动创建一个别名添加到 `~/.zshrc`： ```bash echo 'alias docker-compose="docker compose"' >> ~/.zshrc source ~/.zshrc ``` * **彻底卸载重装**：如果安装混乱，可以先卸载再重装。对于 Homebrew 安装：`brew uninstall docker-compose`。对于 curl 安装：`sudo rm /usr/local/bin/docker-compose`。然后重新按照上述推荐方法安装。 通过以上步骤，您应该可以成功安装并使用 `docker-compose` 命令来便捷地管理您的容器化应用。对于大多数 macOS 用户，**直接安装 Docker Desktop 是最省心且功能最完整的选择**[ref_1]。