Composer命令清单查找与功能分类查看指南

对于初次接触 Composer 的开发者来说，面对 composer list 输出的冗长命令列表，常常感到无从下手。命令按字母顺序排列，install 和 update 等功能相关的命令可能相隔甚远，查找起来非常不便。这并非设计缺陷，而是 Composer 团队有意为之的设计哲学：他们将每个命令视为独立的“函数”，而非按功能模块归类。理解这一核心理念，是掌握 Composer 高效使用的关键。

Composer list 命令的组织逻辑与查看技巧

Composer list 的输出遵循严格的字母顺序排列，没有任何功能分组。这意味着 dump-autoload 和 diagnose 不会因为同属开发相关而被放在一起。这种设计将命令列表定位为一个需要精确查询的 API 索引，而非用于功能探索的菜单。

这也解释了为何一些常见的搜索会失败。例如，执行 composer list | grep "dev" 无法找到 require-dev 命令，因为后者并不存在——--dev 仅仅是 require 命令的一个选项。同样，在项目 composer.json 的 scripts 部分定义的自定义脚本命令，也不会出现在系统命令列表中。

• 插件命令的动态加载：诸如 phpstan:analyse 这类由插件提供的命令，仅在安装了对应插件（例如 PHPStan）的项目目录下才会显示。即使全局安装了插件，若未在当前项目中启用，该命令也不会列出。
• 查看隐藏命令与别名：使用 composer list -a 可以查看包括 self-update 在内的所有隐藏命令。但需注意，此列表不会显示已废弃的短别名，例如旧版本中 install 的别名 i。
• 终端分页处理：当输出内容超过一屏时，Composer 会自动调用终端分页器（如 less）。此时需按 q 键退出浏览界面，切勿误认为是程序无响应。

如何快速定位与搜索 Composer 命令

面对海量命令，逐行查找效率低下。掌握以下过滤技巧，能极大提升命令查找速度：

• 使用前缀匹配：直接输入 composer list [前缀]。例如，输入 composer list dump，Composer 会自动列出所有以 “dump” 开头的命令，如 dump-autoload 和 dump-env（若安装了 vlucas/phpdotenv 插件）。
• 结合 grep 进行过滤：在终端中使用管道配合 grep 命令是更强大的搜索方式。composer list | grep "^u" 能筛选出所有以 u 开头的命令。而 composer list | grep -i autoload 则能不区分大小写地搜索包含 “autoload” 关键词的命令。

一个关键细节：命令名必须严格使用短横线（-）连接。写成 dump_autoload（下划线）或 dump autoload（空格）都会触发 Command "xxx" is not defined 错误。这属于命令格式错误，而非简单的拼写问题。

Composer 插件命令“消失”的原因与排查

插件命令时隐时现，通常并非 Composer 本身的问题，而是由其严格的加载规则所决定：

• 项目级插件：通过项目 composer.json 的 require-dev 引入的插件，你必须先切换到该项目目录下，再运行 composer list，否则相关命令不会出现。
• 全局插件：通过 composer global require 安装的插件，需要确保 COMPOSER_HOME/bin 目录已添加到系统的 $PATH 环境变量中，并且执行命令时未使用 --no-plugins 参数来禁用插件。
• 环境依赖缺失：部分插件依赖特定的 PHP 扩展。例如，roave/security-advisories 插件需要 json 扩展，如果该扩展缺失，插件会静默跳过注册，导致命令“消失”。此时，添加 --verbose 参数运行命令，通常能看到相关的警告提示。

最可靠的验证方法是直接进入项目目录进行搜索：cd /path/to/your-project && composer list | grep phpstan。这比在任意位置猜测更为准确。

找到命令后，务必查看帮助文档

当你通过搜索找到了目标命令，例如 outdated，切勿直接运行。首先应该查看其详细的帮助文档，这是了解命令选项和用法的权威本地指南。

• 运行 composer outdated --help 会告诉你，使用 -D 或 --direct 选项可以仅检查根依赖，而 --minor-only 能过滤掉仅涉及补丁版本的更新。
• 运行 composer install --help 则会明确说明，--no-scripts 选项会跳过 post-install-cmd 等脚本的执行，而使用 --ignore-platform-reqs 可能会在未来运行时引发环境兼容性问题。

需要特别注意，相同的选项名在不同命令中含义可能完全不同。例如，--dev 在 require 命令中表示“将依赖包添加到 require-dev 部分”，而在 update 命令中则表示“仅更新 require-dev 部分的依赖包”。

可以说，--help 是最常被忽略却至关重要的一步。它显示的是你本地 Composer 版本的实际行为，确保了信息的准确性与实时性。在线文档可能存在滞后，而 --help 的输出永远与你当前使用的工具保持同步。