Composer list怎么找命令_Composer功能清单分类查看

刚接触Composer的朋友，大概都对着composer list的输出结果发过懵。满屏的命令按字母顺序排列，install和outdated可能隔着十万八千里，想找个功能相关的命令，眼睛都得看花。这其实不是设计上的疏忽，恰恰是Composer团队的一个明确理念：他们把每个命令都看作独立的“函数名”，而不是按“安装”、“调试”这样的操作路径来归类。理解这一点，是高效使用Composer的第一步。

composer list 输出的命令到底按什么逻辑组织

它的组织逻辑非常直接：纯字母序。你在这里找不到任何功能分组，dump-autoload和diagnose也不会因为都和“开发”沾边就放在一起。这种设计意味着，你不能指望通过浏览列表来“发现”功能，而应该把它当作一个需要精确查询的API索引。

这也解释了为什么一些常见的搜索会失败。比如，composer list | grep "dev"是找不到require-dev命令的，因为压根就没有这个命令——--dev只是require命令的一个选项。同样，你项目composer.json里scripts下定义的自定义命令，也不会注册到这个系统列表中，用grep "script"自然搜不到。

• 插件命令的动态性：像phpstan:analyse这类命令，只在安装了对应插件（如PHPStan）的项目中才会出现。即使全局安装了插件，如果没在当前项目启用，它也不会列出来。
• 隐藏命令与别名：使用composer list -a可以显示包括self-update在内的隐藏命令。但要注意，它不会显示已废弃的别名，比如旧版本中install的短别名i。
• 终端分页：当输出内容较长时，Composer会自动启用终端分页器（如less）。这时需要按q键退出查看，别误以为是程序卡死了。

怎么快速定位你真正需要的命令

面对长长的列表，从头看到尾是最笨的办法。掌握几个过滤技巧，效率能提升十倍：

• 前缀匹配：直接使用composer list dump。输入命令的前几个字母，Composer会自动列出所有匹配项，比如输入dump，就会显示dump-autoload和dump-env（如果安装了vlucas/phpdotenv插件）。
• 使用grep过滤：在终端里用管道结合grep是更强大的方式。composer list | grep "^u"能找出所有以u开头的命令。而composer list | grep -i autoload则能不区分大小写地搜索关键词，确保抓住dump-autoload。

这里有个关键细节：命令名必须严格使用短横线（-）。写成dump_autoload（下划线）或dump autoload（空格）都会导致Command "xxx" is not defined的错误。这属于格式错误，而非拼写错误。

插件命令为什么有时“消失”了

插件命令时有时无，不是Composer不稳定，而是由其加载规则决定的。插件命令只在特定条件下才会注入到命令列表中：

• 项目级插件：通过项目composer.json的require-dev引入的插件，你必须先进入该项目目录，再运行composer list，否则命令不会出现。
• 全局插件：通过composer global require安装的插件，需要确保COMPOSER_HOME/bin目录在你的系统$PATH环境变量中，并且当前执行命令时没有使用--no-plugins参数禁用插件。
• 环境依赖：有些插件依赖特定的PHP扩展。例如roa ve/security-advisories需要json扩展，如果扩展缺失，插件会静默跳过注册，命令也就“消失”了。此时加上--verbose参数运行，通常能看到相关警告信息。

最可靠的验证方法是：cd /path/to/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的输出永远与你手中的工具同步。