应直接调用目标PHP二进制执行Composer，如/usr/bin/php8.1 composer.phar install；config.platform.php仅影响依赖解析，不解决运行时语法错误，切换PHP版本后须彻底删除vendor和composer.lock并重装。
composer install 报 “PHP version does not satisfy that requirement” 怎么办
这不是 Composer 配置问题，而是它正在用错 PHP 解释器。Composer 本身不切换版本，只读取当前 php -v 输出来校验 composer.json 中的 "php": "^8.1" 这类约束。你看到的报错，说明终端里运行的 PHP 版本（比如 7.4）和项目要求（比如 8.1+）不匹配。
别急着改系统默认 PHP —— 那会影响其他项目甚至系统工具。最稳妥的做法是绕过 php 命令软链接，直接调用目标 PHP 二进制文件执行 composer.phar：
-
/usr/bin/php8.1 /path/to/composer.phar install（Linux/macOS） -
"C:\php\php81\php.exe" composer.phar update（Windows，注意引号） - 确认路径有效：
/usr/bin/php8.1 -v或where php81（Windows） - 别用全局
composer命令：它常是 shell 脚本，内部仍调用php，容易失效
为什么 config.platform.php 不能解决运行时错误
config.platform.php 只在依赖解析阶段起作用，属于“编译期伪装”。它告诉 Composer：“假装当前是 PHP 8.2”，从而让 composer install 能生成兼容该版本的 vendor/autoload_*.php 和 composer.lock。但它完全不改变实际运行环境。
常见误用场景：
立即学习“PHP免费学习笔记（深入）”；
- 你在 PHP 7.4 下设
"platform": {"php": "8.2"}，install成功了，但一跑php artisan serve就报错 —— 因为autoload_static.php里用了 PHP 8.2 的语法（如构造器属性提升），7.4 解析失败 - Docker 构建时有用，因为构建环境和运行环境可分离；本地开发时它只是掩耳盗铃
- 它不影响扩展检查：即使你
platform设了mbstring，如果真实 PHP 没启用，运行时照样崩
多版本共存时 vendor 目录为什么总出问题
每次用不同 PHP 版本执行 composer install，生成的 vendor/ 是有状态的：类映射顺序、反射行为、扩展路径、甚至 JSON 编码格式都可能因 PHP 版本而异。最隐蔽的问题不是安装失败，而是“装得进去，跑不起来”。
切换 PHP CLI 版本后，必须彻底清理再重装：
- 删掉整个
vendor/目录和composer.lock - 用目标 PHP 显式执行：
/usr/bin/php8.3 composer.phar install - 验证生成结果：
php -d display_errors=1 -f vendor/autoload.php（不报错才算真正可用） - 别跳过这步：哪怕
composer install显示成功，autoload.php加载失败也会导致后续所有命令（如php artisan）报Class not found
怎么避免每次手动敲长路径
重复输入 /usr/bin/php8.2 composer.phar install 很累，也容易出错。推荐两种轻量方案：
- 加 shell 别名：
alias composer82='/usr/bin/php8.2 /usr/local/bin/composer'，然后直接用composer82 install - 在项目根目录放一个
Makefile，写明：install:<br> /usr/bin/php8.2 composer.phar install
，运行make install - 别依赖
composer.bat（Windows）或全局composer（macOS/Linux）：它们内部硬编码调用php，PATH 一变就不可靠 - Windows 用户特别注意：
composer.bat第二行通常写着@php "%~dp0composer.phar" %*，这里@php仍走系统 PATH —— 必须改这行，或直接弃用
核心就一条：Composer 不管理 PHP 版本，它只是个被解释的脚本。你控制不了它“用哪个 PHP”，只能控制“用哪个 PHP 去解释它”。路径写对了，问题就解决了一半；vendor 清干净了，另一半才真正落地。
