Composer命令行补全默认不生效，需手动执行composer completion bash >> ~/.bashrc或composer completion zsh >> ~/.zshrc并重载配置；仅对全局composer命令有效，支持命令名与选项两级静态补全，不支持包名、版本号等上下文感知补全。
Composer 命令行补全默认不工作，不是你装错了，而是它压根没被 shell 加载——必须手动注册官方 composer completion 脚本到你的 ~/.bashrc 或 ~/.zshrc，且只对全局 composer 命令生效。
为什么 composer req 没反应？
这不是 Composer bug，也不是网络或权限问题。根本原因是：shell（Bash/Zsh）本身不认得 composer 的命令结构，必须靠外部函数定义补全逻辑。默认安装的 Composer 不注入任何 shell 函数，composer completion 命令就是干这个的。
- 执行
composer completion bash应输出以_composer_completion()开头的大段 shell 函数代码；如果报错Command 'completion' is not defined，说明 Composer 版本低于 v2.5.0，先运行composer self-update - Bash 用户需系统级支持：
brew install bash-completion（macOS）或sudo apt install bash-completion（Ubuntu/Debian） - Zsh 用户要确认
compinit已加载——检查~/.zshrc是否含autoload -U compinit; compinit，且composer completion zsh的输出必须放在该行之后 - 局部调用如
php composer.phar require或./vendor/bin/composer install永远不会触发补全，这是设计行为，非配置失败
composer completion bash 和 composer completion zsh 怎么用？
这两个命令不安装、不下载、不联网，只是把当前 Composer 版本支持的命令树“翻译”成对应 shell 能理解的函数。输出内容直接追加进 shell 配置文件即可。
- 一次性写入：
composer completion bash >> ~/.bashrc或composer completion zsh >> ~/.zshrc - 写完务必重载：
source ~/.bashrc或source ~/.zshrc（新开终端也行） - Zsh + oh-my-zsh 用户额外注意：如果
plugins=(... composer ...)存在，建议删掉composer插件项，它会覆盖官方补全 - 验证是否成功：
type _composer_completion应返回函数定义；compgen -A function | grep composer应列出该函数
补全能提示什么？不能提示什么？
官方补全是静态、两级、无上下文的——它不读 composer.json，不查 Packagist，不解析当前项目依赖，只靠预编译的命令结构匹配。
- 能提示：
composer req→require；composer require --→ 列出--dev、--no-update、--with-all-dependencies等所有合法 flag - 不能提示：
composer require larav（包名）、composer require monolog/monolog:^3（版本号）、composer run-script dev-（自定义脚本名） - 不支持模糊匹配：拼错一个字母（如
compoer in）就失效；也不感知当前目录是否有composer.json，哪怕在空目录下也能补全命令名 - 想补包名？得用第三方工具如
inshellisense，它会实时调 API，但不属于 Composer 原生能力
为什么 composer i 有时能用，有时报错？
这不是补全功能，是 Composer 自身的“前缀唯一匹配”机制 + shell 补全的叠加效果，可靠性低，不该依赖。
-
composer i能命中install，是因为当前没有其他命令以i开头；但composer s可能同时匹配show和search，就会报ambiguous -
composer up或composer upd能跑通，纯粹因为 shell 补全先把它补成了完整命令名，再交给 Composer 执行——如果补全没配好，composer up根本不会动 - 真正提效的方式是：敲
composer in补全为install，再接-h查参数（composer install -h），比背缩写快且准 - 别在 CI 脚本或文档里写
composer up这类非标准写法——它可能在别人环境里直接失败
最容易被忽略的一点：补全脚本本质是纯 shell 函数，它不联网、不读文件、不依赖 PHP 运行时，只靠 Composer 内置的命令定义生成。一旦你发现 composer require -- 不列选项，第一反应不该是“是不是网络卡了”，而是检查 composer --version 和 source 是否真的执行成功。
