phpEnv 不管理 Composer，仅切换 PHP CLI 版本；composer install 报错主因是 composer 命令未使用 phpEnv 切换后的 PHP 解释器，而仍调用系统默认 PHP，导致版本不匹配；最稳妥方案是用完整路径直接执行：/path/to/php composer.phar install。
phpEnv 本身不管理 Composer，它只管 PHP CLI 版本切换；Composer 是个 PHP 脚本，运行时依赖当前 shell 的 php 命令指向哪个二进制——所以配置“多版本 Composer”本质是让不同 PHP 版本能各自调用到正确的 composer 执行逻辑，而不是给 Composer 装多个副本。
为什么 phpEnv local 后 composer install 还报错？
因为 phpenv local 8.2.18 只改了当前目录下 shell 的 php 命令指向，但 composer 命令本身可能仍是硬链接或 alias 到旧版本 PHP 解释器，或者它被系统 PATH 里另一个 composer 覆盖了。
-
php -v输出是你期望的 8.2.18，但which composer显示的是/usr/local/bin/composer，而这个文件开头可能是#!/usr/bin/env php—— 它仍会走系统默认php，不是 phpEnv 切换后的那个 - 你执行
composer install时，实际等价于php composer.phar install，而这里php没走 phpEnv 的 shims 路径 - 常见现象：
phpenv local 8.2.18成功，php -v正确，但composer install仍提示 “requires php ^8.2 but your PHP version (7.4.33) does not satisfy”
最稳妥：用完整 PHP 路径直接跑 composer.phar
绕过所有 PATH 和 shebang 陷阱，强制指定解释器。phpEnv 安装的每个版本 PHP 都有明确路径，比如：
- Linux/macOS：
/Users/you/.phpenv/versions/8.2.18/bin/php - Windows（若用 WSL 或 Git Bash）：
/c/Users/you/.phpenv/versions/8.2.18/bin/php
然后这样用：
$/Users/you/.phpenv/versions/8.2.18/bin/php composer.phar install
注意两点：
-
composer.phar必须在当前目录，或写成完整路径（如~/bin/composer.phar） - 如果要用
-d参数（比如开 opcache），必须放在 PHP 路径之后、composer.phar之前：/path/to/php -d opcache.enable_cli=1 composer.phar install
想保留 composer 命令？建项目级 wrapper 脚本
不要全局改 composer，而是按项目配。在项目根目录放一个 composer82（无后缀）脚本：
#!/bin/sh exec /Users/you/.phpenv/versions/8.2.18/bin/php "$(dirname "$0")/composer.phar" "$@"
然后：
chmod +x composer82./composer82 install
好处是：不污染全局环境，不依赖 shell 的 phpEnv hook 是否生效，CI 脚本里也能直接复用该路径。
别碰 config.platform.php 来“假装”版本
在 phpEnv 管理的多版本场景下，composer config platform.php "8.2.0" 是干扰项，不是解法：
- 它只影响依赖解析，不改变
vendor/autoload.php的生成逻辑 —— 你用 PHP 7.4 执行composer install，哪怕设了 platform 8.2，生成的 autoload_static.php 依然基于 7.4 的反射行为，一跑 PHP 8.2 语法就崩 - 它掩盖真实问题：你本该用 8.2 的 PHP 去跑 install，却靠 platform 让 7.4 “假装”能装，结果 runtime 报
syntax error, unexpected token "match" - 一旦提交到团队仓库，队友没配好 phpEnv 或路径不同，
composer install表面成功，上线就挂
真正要做的，永远是让 php 和 composer.phar 在同一上下文里跑起来——路径对齐，版本对齐，别信任何“绕过校验”的捷径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
