结论：phpenv管理多版本PHP最贴近开发者日常，但默认不带PHP版本且phpenv install依赖php-build插件；需手动克隆插件、确保shims生效、按优先级排查.php-version干扰，并解决编译依赖与路径冲突问题。
直接说结论：用 phpenv 管理多版本 PHP 是最贴近开发者日常的方案，但安装后默认不带任何 PHP 版本，phpenv install 命令本身依赖 php-build 插件——这点最容易被跳过，导致执行时报错 command not found: phpenv-install。
phpenv install 命令不存在？先装 php-build 插件
刚装完 phpenv，运行 phpenv install 8.3.13 却提示找不到命令，是因为 phpenv 核心只负责版本切换逻辑，编译安装能力由插件提供。
- 必须手动克隆
php-build到插件目录：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 确认插件路径正确：
ls $(phpenv root)/plugins/应看到php-build目录 - 无需额外启用，只要目录存在，
phpenv install就会自动识别 - 如果仍报错，检查 shell 配置是否已加载
eval "$(phpenv init -)"，否则 shims 不生效
phpenv global 和 phpenv local 切换失效？检查 .php-version 文件优先级
phpenv 的版本解析顺序是：当前 shell 设置（phpenv shell） > 当前目录 .php-version > 全局设置（phpenv global）。项目里一个残留的 .php-version 文件常导致 phpenv global 完全不生效。
- 查看当前生效版本来源：
phpenv version（注意是单数，不是versions） - 输出末尾带
(set by /path/to/.php-version)就说明被本地文件锁定了 - 临时绕过本地设置：加
-s参数强制使用 shell 级别，如phpenv shell 8.2.10 - 删除或修改
.php-version后，记得运行phpenv rehash更新 shims 缓存
安装 PHP 失败卡在 configure 阶段？环境变量和依赖缺一不可
phpenv install 实际是调用 ./configure && make && make install，系统缺少基础编译工具或头文件时，错误信息往往藏在几百行日志末尾，只显示 configure: error: cannot run C compiled programs 这类模糊提示。
立即学习“PHP免费学习笔记（深入）”；
- Ubuntu/Debian 必装依赖：
sudo apt install build-essential autoconf bison libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev libicu-dev libzip-dev - macOS（Homebrew）：
brew install autoconf bison libxml2 openssl@3 icu4c curl，并导出路径：export PATH="/opt/homebrew/opt/bison/bin:$PATH" - 若需启用 OpenSSL 支持，提前设环境变量：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3" - 编译耗时较长（尤其 PHP 8.3+），别误判为卡死；可用
top查看cc或make进程是否活跃
php -v 显示旧版本，但 phpenv version 显示新版本？shims 没生效
这是最典型的“看似装了却没用上”问题。根本原因是 shell 找到的是系统自带的 /usr/bin/php，而非 phpenv 生成的 shim 脚本。
- 检查
which php输出是否以~/.phpenv/shims/php开头；如果不是，说明$HOME/.phpenv/bin没进PATH，或phpenv init没执行 - 验证 shim 是否生成：
ls ~/.phpenv/shims/应包含php、phpize、composer等文件 - 若
shims目录为空，运行phpenv rehash强制重建 - 注意：某些终端（如 VS Code 内置终端）可能未读取
~/.bashrc，需手动source ~/.bashrc或重启终端
真正麻烦的从来不是装几个版本，而是每个版本背后对应的扩展、ini 配置、FPM socket 路径、甚至 Composer 的 vendor/autoload.php 加载顺序——这些都不会随 phpenv 自动迁移，得自己一个个对齐。
