根本原因是Composer用php -v真实版本校验require.php约束；需先运行php -v和which php确认版本与路径一致，再通过/usr/bin/php8.2 composer install等方式显式指定PHP二进制执行。
Composer 安装失败，报 Your requirements could not be resolved 或 requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement，根本原因不是“包装不了”，而是 Composer 正在用你当前 shell 里真实的 php 命令版本去校验 composer.json 中的约束——不匹配就拦，不妥协。
怎么确认当前 Composer 实际用的是哪个 PHP 版本
Composer 不读配置、不猜意图，它只认 php -v 输出。很多问题其实卡在这一步就错了：
- 运行
php -v，看输出是不是你预期的版本（比如PHP 8.2.10） - 再跑
which php，确认路径是否指向你要的那个二进制（例如/usr/bin/php8.2，而不是/usr/bin/php7.4） - 别信终端里 alias 或 export PATH 后没重开 shell 的操作——旧进程里的
php缓存还在 - Docker 或 CI 环境中，
php -v必须和composer install在同一个容器/步骤里执行，否则日志里看到的版本和实际运行的可能不一致
直接指定 PHP 路径调用 Composer 才最稳
与其折腾全局 update-alternatives 或 Homebrew link，不如每次明确告诉 Composer：“用这个 PHP”：
- Linux/macOS：
/usr/bin/php8.2 /usr/bin/composer install（路径以which php8.2为准） - Windows：
"C:\php\php82\php.exe" "C:\composer\composer.phar" install（注意双引号包裹含空格路径） - CI 脚本里务必前置
php -v和ls -l $(which php)打日志，避免“以为切了，其实没切” - 别依赖
composer config platform.php "8.2"就完事——它只影响解析，不改变 runtime；你本地是 PHP 7.4，设了"platform": {"php": "8.2"}后composer install成功了，但一跑match就ParseError
中文路径或环境变量导致的隐性失败
Windows 下常见：XAMPP/WAMP 安装目录含中文（如 C:\xampp\php 或 D:\开发工具\php82），会导致 Composer 解析 autoload_static.php 时路径编码异常，表现为 Class not found 或自动加载失效，错误却不提路径问题：
立即学习“PHP免费学习笔记（深入）”；
- 检查
vendor/autoload.php顶部是否包含类似require_once __DIR__ . '/composer/autoload_real.php';—— 如果路径被截断或乱码，大概率是中文路径惹的祸 - 临时解决：把 PHP 安装到纯英文路径（如
C:\php82），并确保PATH指向它 - Linux/macOS 用户若用
~或中文用户名，也要注意HOME路径是否被 Composer 内部函数（如getenv('HOME')）误处理；建议用绝对路径调用 - composer.json 中所有路径字段（如
config → bin-dir）都应避免中文或空格，否则某些插件（如hirak/prestissimo）会静默失败
删 vendor 和 lock 前，先搞清要不要删
很多人一报错就 rm -rf vendor composer.lock，结果更乱：
- 如果只是切换了 PHP 版本（比如从 8.1 换到 8.2），必须删
vendor/和composer.lock，再重新composer install——因为autoload_static.php是根据当前 PHP 版本反射生成的，混用会加载失败 - 如果只是加了个新包，而
composer.lock还没提交，优先跑composer install --dry-run验证可行性，比硬删安全 - 团队协作中，
composer.lock是权威，不要随意重生成；若需适配新 PHP，应由负责人统一composer update --lock并提交 -
vendor/autoload.php本身不绑定 PHP 版本，但它加载的类可能用了readonly或构造器参数提升（PHP 8.2+），这些语法在旧版本下连文件都 parse 不了——所以“能装上”不等于“能跑通”
