Composer怎么迁移到新版本Composer2_Composer版本升级迁移指南【详解】-composer-PHP中文网

composer self-update无法从1.x升级到2.x是官方设计限制，因1.x与2.x主版本不兼容，self-update仅支持同主版本内小版本更新；必须通过官方安装脚本覆盖重装才能完成升级。

composer怎么迁移到新版本composer2_composer版本升级迁移指南【详解】

直接运行 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