遇到 docker-compose 报错，绝大多数情况是命令拼写错误、权限不足或版本混淆（V1 与 V2），优先检查命令格式和安装状态。
先说结论：先区分你用的是 standalone 脚本还是 CLI 插件，再针对性修复安装或调整命令。
- 先确认：输入
docker compose version和docker-compose version看哪个有反应 - 先处理：根据报错类型重装插件或修正 YAML 语法
- 再验证：运行
docker compose config检查配置能否被识别
命令速用版
如果你不确定当前环境支持哪种命令，可以依次尝试以下指令查看版本信息：
# 尝试 V2 插件命令（推荐）
docker compose version
# 尝试 V1 standalone 命令（旧版）
docker-compose version
# 如果提示找不到命令，安装 V2 插件（Ubuntu/Debian 示例）
sudo apt-get update
sudo apt-get install docker-compose-plugin为什么会这样
Docker Compose 经历过架构调整。早期是独立的 Python 脚本（V1），命令带横杠 docker-compose；后来集成进 Docker CLI 作为插件（V2），命令中间是空格 docker compose。
很多旧教程还在教 V1 写法，但新系统默认只装 V2。此外，权限问题（是否需要 sudo）和 YAML 缩进错误也是高频报错原因。网络问题导致拉取镜像失败也会表现为运行报错。
分步处理
1. 检查命令格式
先确认你输入的命令是否匹配已安装的版本。在新版 Docker 中，docker-compose 可能根本不存在，必须用 docker compose。
2. 检查权限
如果报错 permission denied 或 cannot connect to Docker daemon，尝试在命令前加 sudo，或者将当前用户加入 docker 用户组。
sudo usermod -aG docker $USER
# 之后需要重新登录终端生效3. 检查 YAML 语法
如果版本命令正常，但运行项目报错，通常是 docker-compose.yml 写法有问题。使用配置检查命令定位错误行。
怎么验证是否生效
执行以下命令，如果没有报错且输出了整理后的配置内容，说明环境和文件基本正常：
docker compose config
# 或者旧版
docker-compose config同时观察版本号输出，确保没有警告信息。
常见坑
- 混用命令：脚本里写的是
docker-compose，实际环境只有docker compose，导致 CI/CD 流水线失败。 - 缩进错误：YAML 对缩进敏感，复制粘贴时容易混入 Tab 键，必须用空格。
- 网络超时：运行时报错拉取镜像失败，通常是网络问题，不是 compose 本身的问题。
- 版本兼容性：旧版 compose 文件版本写法（如 version: '3'）在新版中可能被忽略或报错，建议参考最新文档调整。
参考来源
- Docker 官方文档 - Compose 安装说明：https://docs.docker.com/compose/install/
- Docker 官方文档 - 迁移指南（V1 到 V2）：https://docs.docker.com/compose/migrate/