docker compose ls 命令（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代软件开发中，Docker 和 Docker Compose 已成为构建、部署和运行应用程序的基石。随着项目复杂度的提升，开发者需要高效管理容器和组合服务。本文将聚焦于 docker compose ls 命令，深入解析其功能、参数及应用场景。无论你是刚接触容器技术的初学者，还是希望优化开发流程的中级开发者，本文都将为你提供系统化的指导，并通过案例演示帮助你快速上手。

一、Docker Compose 的核心作用与 ls 命令的定位

Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具，它通过 docker-compose.yml 文件简化了复杂服务的配置。例如，一个典型的 Web 应用可能包含 Web 服务器、数据库和缓存服务，这些服务需要协调启动和停止。

而 docker compose ls 命令正是 Docker Compose 的“信息中枢”。它的核心功能是列出当前系统中所有由 Docker Compose 管理的项目，帮助开发者快速定位服务状态，避免手动记忆项目名称或重复执行冗长的命令。

形象比喻：
可以把 docker compose ls 想象为一个“容器化项目的目录索引”。当你在文件系统中使用 ls 查看文件时，它会列出所有可用的 Docker Compose 项目，帮助你快速找到目标项目并执行后续操作（如启动、停止或查看状态）。

二、基础概念与命令解析

1. Docker Compose 项目与服务

Docker Compose 通过 docker-compose.yml 文件定义项目。每个项目可以包含多个服务（如 Nginx、MySQL、Redis 等），每个服务对应一个或多个容器。例如：

version: '3'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: example

2. docker compose ls 的基本语法

docker compose ls [选项]

默认情况下，该命令会列出当前工作目录下的所有 Docker Compose 项目，并显示其状态（如是否正在运行）。

三、命令详解与参数说明

1. 列出所有项目的基本用法

执行以下命令即可查看所有由 Docker Compose 管理的项目：

docker compose ls

输出示例：

NAME    SERVICES   STATUS  
webapp  2          stopped  
blog    3          running  

• NAME：项目名称，默认为当前目录的文件夹名。
• SERVICES：该项目包含的服务数量。
• STATUS：项目的运行状态（如 running 或 stopped）。

2. 参数扩展与高级用法

参数 1：--all

默认情况下，docker compose ls 仅显示当前目录下的项目。若需查看全局所有项目（包括其他目录中的项目），需添加 --all 参数：

docker compose ls --all

输出示例：

NAME    SERVICES   STATUS     WORKDIR  
webapp  2          stopped    /home/user/project/webapp  
blog    3          running    /home/user/project/blog  

• WORKDIR：项目所在的文件路径。

参数 2：--services

若需查看特定项目的服务列表，可结合 --services 参数：

docker compose --project-name blog ls --services

输出示例：

nginx  
mysql  
redis  

参数 3：--format

通过 --format 参数，可以自定义输出格式，例如仅显示项目名称和状态：

docker compose ls --format "table {{.Name}}\t{{.Status}}"

四、实战案例：从创建到管理项目

案例场景

假设你正在开发一个包含 Web 服务和数据库的项目，需要使用 docker compose ls 跟踪项目状态。

步骤 1：创建项目目录和配置文件

mkdir myapp && cd myapp
touch docker-compose.yml

步骤 2：编写 docker-compose.yml

version: '3'
services:
  web:
    image: httpd:latest
    ports:
      - "8080:80"
  db:
    image: postgres:13
    environment:
      POSTGRES_PASSWORD: mypassword

步骤 3：查看项目状态

docker compose ls

初始输出：

NAME    SERVICES   STATUS  
myapp   2          stopped  

步骤 4：启动项目并重新查看状态

docker compose up -d
docker compose ls

更新后的输出：

NAME    SERVICES   STATUS  
myapp   2          running  

五、进阶技巧与常见问题

1. 结合其他命令优化工作流

通过管道符 | 可将 docker compose ls 的输出与其他命令结合，例如筛选运行中的项目：

docker compose ls --all | grep "running"

2. 项目名称的自定义

默认项目名称基于当前目录名称，但可以通过 --project-name 参数手动指定：

docker compose --project-name my_custom_name up -d

3. 常见问题解答

Q：为什么某些项目未显示在 docker compose ls 的输出中？
A：检查是否指定了 --all 参数。若未指定，默认仅显示当前目录的项目。

Q：如何快速停止所有 Compose 项目？
A：结合 docker compose ls 和循环命令：

docker compose ls --all --format json | jq -r '.[].Name' | xargs -I {} docker compose -p {} down

六、总结与延伸学习

docker compose ls 是开发者日常工作中不可或缺的工具，它简化了对多容器项目的管理，避免了手动记录或猜测项目状态的繁琐流程。通过掌握其参数和实际案例，开发者可以更高效地构建、调试和部署复杂的应用架构。

若想进一步提升技能，建议深入学习以下内容：

1. Docker Compose 的高级配置（如网络、卷和依赖关系）
2. 使用 docker compose exec 进入容器调试
3. 结合 CI/CD 工具实现自动化部署

通过持续实践，你将发现 Docker Compose 不仅是一个工具，更是一种优化开发流程的思维方式。