Docker基础教程（178）Docker Compose命令基础之查看项目容器信息的ps命令：深度分析Docker Compose命令基础之查看项目容器信息的ps命令，并附完整示例

引言：从“盲人摸象”到“上帝视角”

想象一下这个场景：你信心满满地敲下 docker compose up -d，一阵华丽的日志滚动后，终端归于平静。你的微服务项目（比如一个Web前端、一个后端API、一个Redis缓存）已经成功启动……了吗？

你挠挠头，尝试访问localhost:3000——一片空白。于是你开始了“盲人摸象”式的排查：

• 新开一个终端，docker ps 看看容器列表，哦，有三个容器在跑。
• docker logs <container_id> 挨个查日志，发现后端容器好像启动失败了。
• 但这几个容器真的属于同一个项目吗？它们之间的依赖关系对吗？端口映射对了吗？

这个过程低效且容易出错。问题的核心在于，普通的 docker ps 提供的是机器全局的容器视图，而当我们使用 Docker Compose 时，我们需要的是一个项目级的视图。这正是 docker compose ps 命令闪亮登场的时刻！它就像是为你当前项目量身定定的“专属考勤系统”或“项目仪表盘”，让你一键获取所有成员的“在岗状态”。

一、docker compose ps：不仅仅是docker ps的简单马甲

首先，我们必须澄清一个常见的误解：docker compose ps 并非 docker ps 的简单重复。它们定位完全不同。

• docker ps: 主机视角。它列出当前Docker守护进程下所有正在运行的容器，无论它们属于哪个Compose项目。当你机器上运行着多个不同项目时，信息会非常嘈杂。
• docker compose ps: 项目视角。它且仅列出由当前目录下的 docker-compose.yml 文件所定义和管理的容器。它理解你的项目结构，提供的信息与你的Compose文件内容紧密相关。

如何使用？
非常简单。只需在你的 docker-compose.yml 文件所在目录下，执行命令：

docker compose ps
# 或者对于较旧版本的Compose V1，使用
# docker-compose ps

二、解密ps命令的输出：读懂你的“项目考勤表”

执行命令后，你会看到一个格式清晰的表格。我们来逐列解析这些信息的深刻含义：

列名	说明	相当于 docker ps 的什么？	独特价值
NAME	Compose项目中的容器名称	--format "{ {.Names}}"