composer help 是查看 Composer 命令帮助最直接的方式,支持本地即时输出所有可用命令说明;执行 composer help [command] 可查具体命令的 Usage、Arguments、Options、Examples 四大区块,含参数格式、选项含义与可运行示例。

composer help 是查看 Composer 命令帮助最直接的方式,它不依赖网络、不需额外安装,所有本地可用命令的帮助说明都能即时输出。
如何快速查某个命令的用法
执行 composer help [command] 即可显示该命令的详细说明、参数列表和使用示例。比如想了解 require 怎么加包并指定版本:
composer help require
输出中会明确列出支持的选项(如 --dev、--no-update)、参数格式(如 package-name:version),以及典型调用方式。
- 不带命令名时(
composer help)只显示顶层命令概览,不含子命令细节 - 拼写错误或命令不存在时,会提示 “Command ‘xxx’ is not defined”,不会静默失败
- 部分命令(如
create-project)的帮助里会包含常用模板别名(如laravel/laravel),可直接参考复制
help 输出里哪些字段最关键
每次 composer help 输出都包含四个固定区块:Usage、Arguments、Options、Examples。重点关注:
-
Usage:展示命令骨架,比如
composer require [--dev] [--no-update] [--no-scripts] [--update-with-dependencies] [--update-with-all-dependencies] [--ignore-platform-reqs] [--prefer-stable] [--prefer-lowest] [--sort-packages] [packages1] ... [packagesN]—— 这说明[packages]是必填位置参数,方括号内是可选开关 -
Options:每个
--xxx后面的描述决定是否需要值,例如--dev无冒号表示布尔开关,--with后跟=VALUE表示必须提供值 -
Examples:给出真实可运行的命令行,比如
composer require monolog/monolog:~1.0,注意版本约束语法(~1.0和^1.0行为不同)
为什么有时候 help 显示不全或格式错乱
这通常不是 Composer 本身的问题,而是终端环境导致:
- Windows CMD 下可能因编码或列宽限制截断长行,建议改用 Windows Terminal 或 Git Bash
- 某些 IDE 内置终端(如 PHPStorm 的 Terminal)未正确设置
$COLUMNS,导致帮助文本换行异常,可临时加--format=txt强制纯文本输出(但该参数仅对少数命令有效,help本身不支持) - 全局配置里若设置了
color=false,help 中的颜色标记会消失,但不影响内容完整性
真正容易被忽略的是:Composer 的帮助文档不会自动同步远程包仓库的变更,比如新发布的插件命令(如 composer normalize)只有在你装了对应插件后,composer help 才会显示它——没装就查不到,不是漏了,是根本不可用。










