Docker Compose: docker-compose 还是 docker compose？别再傻傻分不清！

原创于 2025-10-30 11:27:29 发布 · 1.5k 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#docker #容器 #运维

docker 专栏收录该内容

41 篇文章

订阅专栏

🚀 Docker Compose: `docker-compose` 还是 `docker compose`？别再傻傻分不清！

嘿，各位开发者朋友们！👋

你是否也遇到过这样的场景：在网上兴冲冲地抄了一段 docker-compose up -d 命令，结果终端却无情地告诉你 command not found？或者，你明明记得以前的命令是带连字符的，怎么现在又变成了空格？

别担心，你不是一个人在战斗！这其实是 Docker Compose 发展过程中的一个重要变化：从独立的 V1 版本，进化到了集成的 V2 版本。

今天，我们就来彻底搞懂这两者的区别，让你在未来的容器编排之路上畅通无阻！

📜 故事的开端：V1 时代的 `docker-compose`

在很久很久以前（其实也就几年前 😄），docker-compose 是一个独立的项目。

出身：它是一个用 Python 编写的独立命令行工具。
安装：你需要通过 pip (Pip Installs Packages, Python的包管理器) 或者 apt / yum 等系统包管理器来单独安装它。
命令：它的标志性命令就是我们非常熟悉的，带连字符的 docker-compose。

# V1 时代的经典操作
docker-compose --version
docker-compose up -d
docker-compose ps
docker-compose down

优点 👍：

作为一个独立工具，它与 Docker 引擎本身解耦，可以独立更新。

缺点 👎：

安装麻烦：需要额外管理 Python 环境和 pip，有时会遇到烦人的依赖冲突。
体验不统一：你需要同时学习和使用 docker 和 docker-compose 两套命令体系。

✨ 进化的光芒：V2 时代的 `docker compose`

随着 Docker 的不断发展，官方决定将 Compose 的功能更紧密地集成到 Docker 的核心体验中。于是，Compose V2 诞生了！

出身：它不再是一个独立的 Python 程序，而是用 Go 语言重写，并作为 Docker CLI (Command Line Interface, 命令行界面) 的一个插件存在。
安装：它现在通常与 Docker Desktop (Windows/Mac) 或新版的 Docker Engine (Linux) 捆绑安装。你安装好 Docker，就自动拥有了 docker compose。
命令：最显著的变化！命令中的连字符 - 变成了空格，成为了 docker 主命令的一个子命令。

# V2 时代的现代化操作
docker compose version
docker compose up -d
docker compose ps
docker compose down

优点 👍：

安装简单 ✅：安装 Docker 就够了，无需关心 Python 或其他依赖。
体验统一 ✅：所有操作都以 docker 开头，命令结构更清晰、更符合直觉 (docker container ls, docker image ls, docker compose up)。
性能提升 ✅：用 Go 语言重写，通常比 Python 版本有更好的性能。
功能更强 ✅：支持更多新特性，例如 docker compose cp, docker compose ls 等。

缺点 👎：

兼容性阵痛：很多旧的教程、博客和自动化脚本仍然在使用 docker-compose (V1) 命令，这给新手带来了困惑。

🧐 如何判断我用的是哪个版本？

非常简单，打开你的终端，分别运行以下两个命令：

检查 V2 版本：
```
docker compose version
```
如果输出了版本号（例如 Docker Compose version v2.34.0），说明你正在使用现代的 V2 版本。
检查 V1 版本：
```
docker-compose --version
```
如果输出了版本号（例如 docker-compose version 1.29.2），说明你的系统上还安装着旧的 V1 版本。

小贴士 💡：在很多新系统中，你可能同时安装了 V1 和 V2。为了避免混淆，推荐始终使用 docker compose (V2) 命令。Docker 官方已经宣布 V1 版本不再积极维护，V2 才是未来。

🤖 在自动化脚本中如何兼容？

如果你正在编写一个需要在不同环境中运行的部署脚本 (deploy.sh)，如何确保它能同时兼容 V1 和 V2 呢？

这里有一个非常实用的 Shell 脚本片段：

#!/bin/bash

# 自动检测可用的 Docker Compose 命令
if command -v docker-compose >/dev/null 2>&1; then
    # 如果旧的 V1 命令存在
    COMPOSE_CMD='docker-compose'
elif docker compose version >/dev/null 2>&1; then
    # 如果新的 V2 命令存在
    COMPOSE_CMD='docker compose'
else
    # 如果两者都不存在
    echo "❌ 错误: Docker Compose 未安装。" >&2
    exit 1
fi

echo "✅ 将使用 '$COMPOSE_CMD' 命令来执行操作。"

# 后续所有操作都使用这个变量
$COMPOSE_CMD up -d
$COMPOSE_CMD ps

这个脚本会智能地检测可用的命令，并将其存入一个变量 COMPOSE_CMD 中，让你的脚本变得更加健壮和通用！

结语

拥抱未来吧！从现在开始，养成使用 docker compose (V2) 的好习惯。如果遇到旧的教程，记得把命令中的连字符替换成空格，你的容器编排之旅将会更加顺畅！🚀

附录：总结与图表

📊 Docker Compose V1 vs V2 对比总结

特性	Docker Compose V1	Docker Compose V2
命令	`docker-compose` (带连字符)	`docker compose` (带空格)
本质	独立的 Python 程序 🐍	Docker CLI 的 Go 语言插件 🐹
安装	需通过 `pip` 或 `apt` 单独安装	随 Docker Desktop/Engine 捆绑安装
状态	停止维护 🛑	官方推荐 ✅
优势	兼容旧系统	安装简单、性能更优、体验统一

🗺️ Mermaid 流程图：命令选择逻辑

🔄 Mermaid 时序图：开发者与不同版本 Compose 的交互

🚦 Mermaid 状态图：Compose 的演进

🏛️ Mermaid 类图：V1 与 V2 的结构差异

在这里插入图片描述

🔗 Mermaid 实体关系图：命令与程序的关系

🧠 Markdown 思维导图

Docker Compose V1 vs V2 深度解析
- 核心变化
  - 命令：docker-compose (连字符) 变为 docker compose (空格)
  - 本质：从独立 Python 程序变为 Docker CLI 的 Go 语言插件
- Docker Compose V1 (旧版)
  - 特点
    - 独立 Python 程序 🐍
    - 需单独安装 (pip, apt)
    - 命令: docker-compose
  - 缺点
    - 安装配置相对复杂
    - 体验不统一
    - 已停止维护 🛑
- Docker Compose V2 (新版/推荐)
  - 特点
    - Docker CLI 插件 (Go 语言) 🐹
    - 随 Docker 捆绑安装
    - 命令: docker compose
  - 优点
    - ✅ 安装简单
    - ✅ 体验统一
    - ✅ 性能更优
    - ✅ 功能更强
- 如何选择与兼容
  - 版本检查
    - V2: docker compose version
    - V1: docker-compose --version
  - 使用建议
    - 始终优先使用 V2 (docker compose)
  - 自动化脚本兼容方案
    - 使用 if 语句检测可用命令
    - 将检测结果存入变量 COMPOSE_CMD
    - 后续统一使用 $COMPOSE_CMD 执行操作
- 结论
  - 拥抱 V2，它是未来 🚀
  - 遇到旧教程，记得将 - 变为空格