如何从 Composer 1 无缝升级到 Composer 2？

直接运行 composer self-update 即可升级到 Composer 2，多数项目无需修改；但需确认 PHP ≥7.2、备份配置、验证插件兼容性及 lock 文件升级，并测试 install/update/require 等命令。

直接运行 composer self-update 就能升级到 Composer 2，大多数项目无需修改即可正常工作。但为避免潜在兼容问题，建议按步骤操作并做简要验证。

确认当前版本并备份旧配置

先检查当前 Composer 版本：

composer --version

如果显示 Composer version 1.x.x，说明还在使用 v1。升级前可备份全局配置（如自定义 repo、auth 配置）：

• 配置文件通常在 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows）
• 复制一份该文件，以防升级后需回退或排查问题

执行升级命令

运行以下任一命令均可升级到最新稳定版 Composer 2：

• composer self-update（推荐，自动选择最新稳定版）
• composer self-update --2（明确指定 v2 分支）

升级完成后再次运行 composer --version，应显示类似 Composer version 2.x.x。

标签： php linux js json composer windows app mac macos win 配置文件 co