Composer v2.5.0+才内置completion命令，旧版报“Command not defined”；补全仅支持命令名与选项，不支持包名、版本等自由输入项，且须按shell类型（Bash/Zsh）正确注册脚本并确保加载顺序。
composer completion 命令没反应？先确认 shell 类型和 Composer 版本
只有 Composer v2.5.0+ 才内置 composer completion 命令。低于这个版本执行会报错 Command "completion" is not defined。别急着找第三方脚本——旧版压根不支持该功能。
同时，composer completion 输出的内容必须适配当前 shell：Bash 和 Zsh 的补全逻辑完全不同，混用会导致 TAB 失效或报错 command not found: _completion_loader。
- 检查版本：
composer --version，确保输出含2.5.0或更高 - 确认当前 shell：
echo $SHELL，别只看终端标题栏（VSCode 里可能默认是 PowerShell，但composer completion zsh对它完全无效） - Zsh 用户若用 oh-my-zsh，需确认
compinit已加载且未被插件覆盖——可临时注释掉~/.zshrc中的插件段再测试
补全脚本追加到配置文件后仍不生效？路径和加载顺序是关键
执行 composer completion bash >> ~/.bashrc 后，很多人直接关终端重开，结果 TAB 还是没反应。问题不在命令本身，而在 shell 配置的加载链路是否真正触达了补全逻辑。
- Bash 必须确保
/usr/share/bash-completion/bash_completion已被 source——检查~/.bashrc或/etc/profile.d/bash_completion.sh是否有对应语句；Ubuntu 22.04+ 默认路径可能是/usr/share/bash-completion/bash_completion，不是旧版的/etc/bash_completion - Zsh 下，
composer completion zsh输出的代码必须放在compinit调用之后；oh-my-zsh 默认在~/.zshrc末尾调用compinit，所以补全代码得放在这行之后 - 改完配置后别只
source ~/.bashrc，还要验证是否加载成功：complete -p | grep composer应输出类似complete -F _composer composer
为什么 alias composer=php /path/to/composer.phar 无法补全？
shell 补全绑定的是命令名（即 composer 这个字符串），不是它的实际执行路径或 alias 展开结果。alias 只影响命令执行，不参与补全注册流程。
- 执行
alias composer='php /opt/composer.phar'后，complete -F _composer composer依然有效，但complete -F _composer php不会自动生效 - 如果 alias 名不是
composer（比如alias c=php /opt/composer.phar），那补全完全不会触发——complete不识别 alias 别名 - 解决办法只有两个：要么把 alias 改成
composer，要么手动为别名注册补全：complete -F _composer c（前提是_composer函数已定义）
补全只能提示命令和选项，包名/版本号补全为什么做不到？
Composer 官方补全只覆盖 composer install、composer require --dev 这类固定语法结构，不解析 composer require guzzlehttp/guzzle:^7.0 中的包名或版本约束——因为这些属于自由输入项，没有预定义枚举集，补全引擎无法安全预测。
- 包名补全需要实时查询 Packagist API 或本地
vendor/目录，官方补全脚本刻意避开这类耗时/网络依赖操作 - 版本号补全更复杂：约束语法（
^2.0、~3.1、dev-main）无法靠静态规则覆盖，且不同包的可用版本差异极大 - 真要实现，得自己写函数调用
composer show -N或解析composer.lock，但性能差、易出错，官方明确不支持
补全的边界就在这里：它只管“命令怎么敲”，不管“参数值是什么”。想补全包名，老实用 IDE 插件或 composer search 配合 Ctrl+R 查历史命令更靠谱。
