你要的是GitHub上的CLI版phpenv（类rbenv的PHP版本管理器），而非Windows图形化集成环境PHPEnv；前者需git、编译工具链及php-build插件，通过源码编译安装并依赖shim机制切换版本。
phpenv 不是双击安装的 Windows 软件，它没有官网下载页或 exe 安装包 —— 你看到的“PHPEnv”图形界面工具（带 Apache/MySQL 集成）和命令行工具 phpenv 是两个完全不同的项目，混用会导致路径冲突、命令失效、版本识别失败。
怎么确认自己要的是哪个 phpenv
如果你需要：
- 在终端里用
phpenv install 8.3.13安装 PHP、phpenv local 7.4.33切换项目版本 → 你要的是 GitHub 上的phpenv（纯 CLI 工具） - 点按钮启动 Apache、开面板管理 MySQL、拖文件建站点 → 你要的是第三方打包的 Windows “PHPEnv”集成环境（非开源、无源码、不支持 macOS/Linux）
当前所有权威文档和社区维护都指向前者：phpenv 是类 rbenv/pyenv 的 shell shim 版本管理器，只管 PHP 解释器本身。
正确安装 phpenv（CLI 版）的三步硬要求
跳过任何一步，phpenv install 都会报错 command not found: phpenv 或 php-build: command not found：
立即学习“PHP免费学习笔记（深入）”；
- 必须先装
git和编译工具链（gcc,make,autoconf），否则phpenv install直接卡在 configure 阶段 - 必须手动克隆到
$HOME/.phpenv，路径不能改；其他位置（如/usr/local/phpenv）会导致phpenv init输出错误的 shim 路径 - 必须安装
php-build插件：它不在主仓库里，需单独执行git clone https://github.com/php-build/php-build.git $(phpenv root)/plugins/php-build
验证是否到位：运行 phpenv install --list | head -n3 应该能列出可用版本；若报错 No php-build installation found，说明插件缺失。
为什么 phpenv install 总是失败或超慢
常见原因不是网络差，而是本地构建依赖没装全：
- Ubuntu/Debian：缺
libxml2-dev,libssl-dev,zlib1g-dev,libcurl4-openssl-dev→apt install补齐 - macOS：用 Homebrew 装完
openssl@3后，必须设export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3"，否则 configure 找不到头文件 - 国内用户：默认源走 GitHub，可加环境变量
export PHP_BUILD_MIRROR=https://ghproxy.com/https://github.com加速下载
注意：phpenv install 是从源码编译，不是下载二进制包。一次成功耗时 5–15 分钟属正常，别误判为卡死。
装完 phpenv 却 still using system PHP？
这是最隐蔽也最常被忽略的问题：shim 机制没生效。
- 检查
which php输出是不是$HOME/.phpenv/shims/php；如果是/usr/bin/php，说明eval "$(phpenv init -)"没执行，或执行了但 shell 配置文件（.bashrc/.zshrc）没 reload - 检查
phpenv version是否显示当前目录匹配的版本；如果显示system，说明没设 global、local 或 shell 版本，或者.php-version文件写错了（内容只能是类似8.3.13，不能带空格或注释） - 新终端里运行
php -v前，务必先执行phpenv rehash—— 这步不手动跑，新装的 PHP 二进制不会被 shim 自动识别
复杂点在于：它不报错，只是静默 fallback 到系统 PHP。你得靠 which php 和 phpenv version 交叉验证，而不是只信 php -v 的输出。
