直接运行 composer --version 是查看当前 shell 调用的 Composer 可执行文件版本的唯一可靠方式，输出如“Composer version 2.7.7 (2024-06-12 13:45:00)”，其中 2.7.7 为真实语义化版本号，括号内为官方 PHAR 构建的 UTC 时间戳；composer -v 单独执行不显示版本，仅等价于 composer list，因其 -v 是 verbose 开关而非 version 缩写；项目实际使用的 Composer 版本可能与全局不同，需通过 which composer 或 php composer.phar --version 精准确认路径与版本一致性。
直接运行 composer --version 就能看到当前生效的 Composer 版本号，但这个“当前”未必是你项目实际用的那个——它只反映 shell 调用的可执行文件版本。
为什么 composer -v 不显示版本号
composer -v 中的 -v 是 verbose（详细日志）开关，不是 version 缩写。单独运行时它等价于 composer list，只输出命令帮助列表，不包含任何版本信息。
- 真正查版本必须用
--version（推荐）或-V（大写 V，部分旧版不支持） - 如果你习惯打
composer -v后发现没输出版本，不是环境问题，是命令本身就不干这事 - 想开 verbose 日志？得配合其他命令，比如
composer install -v或composer update -v
怎么确认项目里真正跑的是哪个 Composer
全局安装的 composer 和项目根目录下的 composer.phar 或 vendor/bin/composer 可能版本不同，CI 报错常源于此。
- 先看调用路径：
which composer，确认你敲的composer指向哪 - 项目里有
composer.phar？优先用php composer.phar --version查它 - Laravel/Symfony 项目中，
php artisan或bin/console的版本号和 Composer 无关，别拿它当依据 - 某些 Docker 镜像会重命名或包装
composer（如composer-stable），用ls -l $(which composer)看真实指向
composer --version 输出里的日期不是你装的时间
输出形如 Composer version 2.7.7 (2024-06-12 13:45:00)，括号内是官方 PHAR 构建的 UTC 时间戳，和你本地下载、安装、升级时间完全无关。
- 如果看到
dev-main或带+git后缀，说明不是官网标准包，而是从源码构建的开发版，self-update 可能失效 - 版本号开头是
2.x表示 v2，1.x已停更；v1/v2 在锁文件格式、插件机制、依赖解析逻辑上不兼容 - 别只盯着版本号，顺手跑一遍
composer diag，它能暴露 CA 证书、git 配置、临时目录权限等真实运行障碍
查不到版本？先排除 PATH 和权限干扰
command not found: composer 几乎都不是没装，而是没进 $PATH，或者被权限/用户上下文干扰。
- Mac 上用 Homebrew 安装但没
brew link composer？which composer会为空 - Windows 上同时存在
composer-setup.exe和手动下载的composer.phar？.bat 文件可能调用错误 PHP 导致静默失败 - 用了
sudo composer --version？读取的是 root 用户配置，和当前用户不一致 - 实在找不到？试试
php /path/to/composer.phar --version，只要你知道composer.phar在哪
最麻烦的不是查不出版本，而是查出来是 v2，但 composer.lock 是 v1 格式写的，或者 CI 用的镜像是 v1 ——这时候光改命令没用，得对齐 lock 文件头的 content-hash 和 platform-check 配置。
