composer install 不生成 completion 脚本，因其仅提供 composer completion 命令手动输出补全脚本，不自动安装或注册；需手动保存并配置 shell 加载，且脚本仅适配当前使用的 composer 可执行路径及 shell 类型。
composer install 之后为什么没有生成 completion 脚本？
因为 composer 默认不自动生成或安装 shell 补全脚本——它只提供生成能力，且仅限于当前项目根目录下的 composer 命令（即 php composer.phar 或全局安装的二进制），不自动写入系统级补全路径。
常见错误现象：composer list 能用，但 composer up<tab></tab> 没反应；或者手动运行 composer completion bash 输出了一堆内容却没生效。
-
composer completion是一个「输出到 stdout」的命令，不会自动保存或注册到 shell - 它只对当前可执行的
composer生效：如果你用的是php composer.phar，那补全脚本也只适配这个路径，不是composer - bash 和 zsh 的补全机制不同，不能混用脚本（zsh 需要
compdef，bash 用_completion_loader）
如何为全局 composer 命令生成并启用 bash 补全？
核心是两步：生成脚本 + 让 shell 加载它。bash 下最稳妥的方式是把脚本写入 ~/.bash_completion 或独立文件后 source。
- 先确认你的
composer是全局可执行的：which composer应该返回类似/usr/local/bin/composer - 生成脚本：
composer completion bash > ~/.composer-completion.bash - 在
~/.bashrc末尾追加：source ~/.composer-completion.bash - 重载配置：
source ~/.bashrc，然后试composer in<tab></tab>
注意：如果 ~/.bash_completion 已存在且被 ~/.bashrc 加载，也可以直接 composer completion bash >> ~/.bash_completion，但后续升级 composer 后需重新追加（它不覆盖）。
zsh 用户为什么 composer completion zsh 仍不生效？
zsh 补全依赖 fpath 和 compinit，光有脚本不够，还必须确保补全系统已初始化，且脚本位置在 zsh 能扫描到的路径里。
- 生成脚本：
composer completion zsh > ~/.zsh-completion/_composer - 确保
~/.zsh-completion在fpath中：在~/.zshrc中加入fpath=(~/.zsh-completion $fpath) - 必须在
fpath设置后调用compinit（通常放在~/.zshrc靠后位置） - 重启终端或运行
rm -f ~/.zcompdump* && compinit强制重建补全缓存
常见坑：compinit 被多次调用会报错；_composer 文件权限没问题，但名字必须以 _ 开头；fpath 添加太晚（比如在 compinit 之后）会导致忽略该路径。
项目内自定义命令补全失效怎么办？
composer 的 completion 命令只补全内置命令和 scripts 中声明的顶层键名（如 "scripts": {"dev:up": "..."} → 补全 dev:up），但它**不会动态解析 PHP 类、方法或参数结构**。
- 如果你写了
composer run dev:up -- --force，--force不会被补全——那是你脚本内部逻辑，composer 不知道 - 想补全参数，得自己写 shell 函数封装，或改用
symfony/console的CompletionCommand（与 composer 无关） - 检查
composer.json的scripts是否用了合法 key 名：含空格、点号以外的符号（如@、/）可能导致补全失败
真正容易被忽略的是：补全脚本生成时，composer 读取的是当前工作目录下的 composer.json。你在 /tmp 目录跑 composer completion bash，它不会加载你项目里的 scripts —— 必须 cd 进项目根目录再执行。
