Composer self-update无法从1.x升级到2.x是官方设计限制，因1.x与2.x主版本不兼容，self-update仅支持同主版本内小版本更新；必须通过官方安装脚本覆盖重装才能完成升级。
直接运行 composer self-update 无法从 1.x 升级到 2.x，这是设计限制，不是操作失误。
为什么 composer self-update 不起作用
Composer 明确禁止跨主版本自动升级：self-update 只能升小版本（如 1.10.22 → 1.10.23），但绝不允许 1.x → 2.x。这不是 bug，是防止静默破坏的强制隔离。
- 运行
composer --version看到的是1.10.22这类输出？说明你卡在已停止维护的旧版里 - 某些系统（Homebrew、Docker 预装镜像）会把
composer硬链接到只读路径，self-update表面成功，实际没写入新文件 - 用
which composer和ls -l $(which composer)查真实路径和符号链接状态，比只看--version更可靠
怎么安全落地 Composer 2.x
最稳的方式是绕过所有包管理器和权限陷阱，直接下载并覆盖安装官方签名的 composer.phar。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行四行命令（含 SHA384 校验，防篡改）：
php -r"copy('https://getcomposer.org/installer', 'composer-setup.php');" php -r"if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6dc97f') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer php -r"unlink('composer-setup.php');" - 若提示
Permission denied，别硬加sudo，改用户级安装：php composer-setup.php --install-dir=$HOME/bin --filename=composer，再确保$HOME/bin在$PATH中 - 升级后立刻跑
composer diagnose，它会告诉你签名是否启用、插件是否兼容等关键状态
升级后 composer install 报错或卡住？先查这三处
常见现象不是语法错误，而是环境/配置/插件不兼容导致的静默失败或误判。
-
Your lock file does not contain a compatible set of packages：必须删掉vendor/和composer.lock，再composer install。Composer 2.x 的 lock 格式是 v2，含content-hash和多平台哈希，1.x 生成的 lock 文件完全不可复用 -
Plugin installation failed或命令卡在Package operations: 0 installs, 0 updates...：检查composer.json里"config": { "plugins": ... }是否启用了老插件（如hirak/prestissimo），它们只支持 plugin-api v1，2.x 默认启用 v2 沙箱，一加载就失败 -
Package foo has a PHP requirement incompatible with your PHP version：不是包真不兼容，而是config.platform没生效或被忽略。Composer 2.x 对 platform 配置更严格，且默认启用check-platform-reqs，建议部署前先跑composer check-platform-reqs
容易被忽略的细节
很多人以为升级完就结束了，其实最关键的迁移动作发生在 composer.json 和本地环境之间。
-
dump-autoload --optimize已被移除，改用dump-autoload -o或依赖自动优化（如 APCu） -
require --dev默认不再修改autoload-dev，要加--update-with-dependencies才同步子依赖 - Linux 下注意路径大小写：Windows 能跑通的
"App\Http\Controllers\": "app/Http/Controllers"，在 Linux 上可能因目录名是app/http/controllers导致Class not found - CI 脚本里不能假设
composer install总是成功——得先判断 lock 文件版本：grep -q '"lock-version": 2' composer.lock
