composer --version是唯一可靠、不依赖项目上下文的查版本方式，输出如“Composer version 2.7.7 (2024-06-12 13:45:00)”，其中2.7.7为真实语义化版本号，括号内是官方PHAR构建UTC时间戳，与本地安装或升级时间无关；composer -v仅为verbose开关，单独执行等价于composer list，不显示版本信息。
composer --version 是唯一可靠、不依赖项目上下文的查版本方式，输出形如 Composer version 2.7.7 (2024-06-12 13:45:00) —— 其中 2.7.7 是真实语义化版本号，括号内是官方 PHAR 构建的 UTC 时间戳，**和你本地安装或升级时间完全无关**。
为什么 composer -v 不显示版本？
composer -v 中的 -v 是 verbose（详细日志）开关，不是 version 缩写。单独执行时它等价于 composer list，只输出命令帮助列表，**不会出现任何版本信息**。
- 想开日志？必须配合其他命令，例如
composer install -v或composer update -v -
composer -V（大写 V）在部分旧版中可用，但 Composer 2.5+ 已明确弃用短选项，行为不稳定，推荐统一用--version - CI 脚本里写
composer -v | grep "version"？大概率匹配失败，应改为composer --version
怎么确认实际运行的是哪个 composer？
你敲下的 composer --version 只反映 shell 找到的第一个可执行文件，未必是项目真正用的那个——尤其当全局安装、项目根目录下有 composer.phar、或 vendor/bin/composer 并存时。
- 先查路径：
which composer（Linux/macOS）或where composer（Windows） - 若项目根目录存在
composer.phar，优先用php composer.phar --version验证它 - 某些 Docker 镜像会包装成
composer-stable，用ls -l $(which composer)看真实指向 - Laravel/Symfony 项目中的
php artisan --version和 Composer 版本无关，别混用
composer self-update 为什么报错？
从 Composer 2.5.0 开始，self-update 命令已被彻底移除。你现在执行 composer self-update，一定会看到 Command "self-update" is not defined。
- 这不是权限或网络问题，是官方主动删除
- 安全升级唯一路径：用官方安装脚本重装 ——
curl -sS https://getcomposer.org/installer | php，再移至$HOME/.local/bin/composer - PHP 版本必须 ≥ 8.0（Composer 2.5+ 使用 PHP 8.0+ 语法），否则重装后运行
composer --version会直接报ParseError - 镜像源配置（如阿里云）不会自动继承，重装后需手动恢复：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
看到 dev-main 或没日期，说明什么？
输出类似 Composer version 2.x-dev (dev-main)，代表你用的是从源码构建（如 git clone + php install.php）的开发版，不是官网发布的稳定 PHAR 包。
- 这类版本通常没有精确时间戳，
self-update可能不生效 - CI/CD 中功能一致，但签名验证、自动更新、插件加载行为可能受限
- 想确认是否为官方包？看输出是否有完整日期时间戳；有，基本就是标准 PHAR
- 真正难判断的不是版本号本身，而是
composer.lock顶部的content-hash是否与当前环境的platform-check匹配 —— 不同版本反复重写 lock 文件后，这个细节最容易被跳过
