Composer怎么查看锁定的包列表_Composer lock内容查看方法【入门】

在日常开发中，我们经常需要确认项目到底锁定了哪些依赖包。很多人第一反应就是用 composer show，但这个命令的输出结果有时会让人困惑——它到底显示的是全部锁定的包，还是只挑了部分给你看？

先说结论：composer show 确实是查看 composer.lock 中已锁定包的最直接方式，但它默认只展示顶层依赖。换句话说，如果你想知道 lock 文件里“实际锁了哪些包”，单纯执行 composer show 是不够的，还得配合 --all、--tree 这些参数，或者干脆直接解析 JSON 结构。

composer show 默认输出只反映顶层依赖

当你执行 composer show 时，Composer 解析的是 composer.lock 中的 packages 字段（注意不是 packages-dev），而且它会跳过所有传递依赖。举个例子：你安装了 lara vel/framework，它拉进来的 symfony/console 和 psr/log 这些间接依赖，在默认列表里是看不到的。这不是 Composer 漏掉了，而是设计如此。

这里有几个需要注意的地方：

• 如果想确认某个间接依赖是否被锁住，必须用 composer show --tree vendor/package 展开依赖树路径
• 如果项目是用 --no-dev 安装的，require-dev 里的包不会进入 packages 字段，composer show 自然不会显示它们
• 如果输出为空或者报“No packages found”，先检查是否在项目根目录，以及 composer.lock 文件是否存在且未损坏

查看完整锁定列表的正确方式

这里有个常见的误解：composer show --all 并不是用来查看本地 lock 文件的，它实际上是请求 Packagist API 获取远程所有可用版本——这和“看 lock 内容”完全是两回事。所以，真正要导出 composer.lock 里所有已锁定包（包括 dev 依赖和传递依赖），推荐以下两种方式：

• 用 composer show --format=json | jq '.[] | select(.name) | "\(.name) \(.version)"'（需要安装 jq）提取包名和版本号，还原 lock 中的完整包集合
• 直接读取 vendor/composer/installed.json：这个文件是 Composer 运行时生成的实际安装快照，比 composer.lock 更贴近磁盘上的真实状态；不过它不包含版本约束信息
• 千万别依赖 composer show -a：这个 -a 是 --all 的旧别名，在 Composer 2.2+ 版本中已经被弃用，行为不稳定，有时会静默忽略

为什么 composer show 不等于 cat composer.lock

composer show 是一个高层抽象命令，它不会逐行读取 lock 文件，而是解析其结构后做筛选和格式化。这意味着：

• lock 文件里明明有 "monolog/monolog": {"version": "3.5.0", ...}，但如果这个包被声明在 require-dev 里，而你运行过 composer install --no-dev，那么 composer show monolog/monolog 就会失败
• 某些私有包或 path repository 类型的包，在 lock 中可能只有 source 字段而没有 dist 字段，composer show 虽然能显示，但不会告诉你它是从本地路径加载的
• 如果你手动修改过 composer.lock 但没有运行 composer install，composer show 的输出和 vendor/ 目录的实际内容可能不一致——它依据的是 lock 文件，而不是磁盘上的实际文件

排查 lock 和 vendor 不一致的最快方法

当你怀疑依赖状态混乱时（比如 CI 报错说找不到类，但 composer show 显示包已安装），不要急着反复执行 composer update，先做三件事：

• 运行 composer show --direct --name-only | sort，然后对比 composer.json 的 require 和 require-dev 字段，确认声明与“声称安装”的顶层包是否对得上
• 执行 ls vendor/ | sort，查看目录是否存在、名称大小写是否匹配（Linux 下 Monolog/Monolog 和 monolog/monolog 是两个完全不同的目录）
• 用 composer validate --strict 检查 composer.lock 语法是否合法，以及是否与 composer.json 兼容；验证失败说明 lock 文件可能被手动改坏了

从本质上看，lock 文件就是一个声明式快照，而 composer show 只是它的一个视图。真正可靠的依据永远是：lock 文件本身 + vendor 目录 + autoload 机制是否能够正常工作。只有这三者一致，项目的依赖状态才是真实可信的。