Composer completion命令无反应大概率因版本低于v2.5.0，需执行composer self-update升级；升级后输出应以_composer_completion()函数开头，且仅支持命令名与选项补全，不支持包名或版本号补全。
composer completion 命令为什么没反应？
执行 composer completion bash 或 composer completion zsh 报错或输出为空，大概率是 Composer 版本太低。官方补全功能从 v2.5.0 才内置，低于该版本会提示“Command 'completion' is not defined”。
- 检查当前版本：
composer --version，若显示Composer version 2.4.x或更低，必须先升级 - 升级命令：
composer self-update（需有写权限，如报错可加--snapshot或用sudo） - 升级后重试，正常输出应以
_composer_completion()函数开头，且含大量complete -F _composer_completion composer类语句 - 别从 GitHub 手动下载旧版补全脚本——它们不支持
composer require --dev --with-all-dependencies这类嵌套选项补全
补全生效了，但只补命令名，不补包名或版本号？
这是预期行为，不是配置错误。Composer 官方补全只覆盖两级：
- 第一级：命令名补全（
composer req<tab></tab>→require） - 第二级：该命令的合法 flag 和参数名（
composer require --<tab></tab>→ 列出--dev、--no-update等）
它不补：
- 包名（
composer require larav<tab></tab>不会出laravel/framework） - 版本约束（
composer require monolog/monolog:^3<tab></tab>不会展开可用版本） -
./vendor/bin/composer或php composer.phar调用方式——补全只绑定全局composer命令
如果需要包名补全，得靠 inshellisense 这类第三方工具，它能实时解析 Packagist API，但属于额外依赖，非 Composer 原生能力。
立即学习“PHP免费学习笔记（深入）”；
Zsh 下补全失效，尤其是用了 oh-my-zsh
Zsh 默认启用补全，但 oh-my-zsh 的插件（如 composer 插件）常会覆盖或禁用官方补全逻辑，导致 composer 命令按 TAB 没反应。
- 先确认
compinit已加载：在~/.zshrc中检查是否含autoload -U compinit; compinit - 把
composer completion zsh输出追加到~/.zshrc时，必须放在compinit调用之后，否则被跳过 - 临时禁用 oh-my-zsh 的 composer 插件：在
~/.zshrc的plugins=(...)列表中删掉composer - 验证是否加载成功：
type _composer_completion应返回函数定义；compgen -A function <em>composer</em>应列出该函数
为什么设置了 EDITOR，composer init 还是打开 vim？
composer init 是否调用 $EDITOR，取决于它是否进入“编辑 composer.json 文件”环节。这个环节只在以下条件同时满足时触发：
- 命令运行在交互式终端（
posix_isatty(STDIN)为 true） - 项目根目录下没有已存在的
composer.json - 没有传
--no-interaction或环境变量COMPOSER_NO_INTERACTION=1
如果已有 composer.json，init 会直接报错退出，根本不会走到编辑步骤；如果在 CI 或 Docker 里跑，即使设了 EDITOR，posix_isatty(STDIN) 返回 false，Composer 就不会尝试调用编辑器。
最关键的是 --wait 参数：VS Code 必须用 code --wait，Sublime Text 用 subl -n -w，否则编辑器一弹出 Composer 就继续执行，保存的文件可能为空或被忽略。
