phpEnv 没有官方安装包，所谓“安装包”多为第三方集成环境，与真正的命令行工具 phpenv 无关；正确方式是 git clone 源码 + 配置 shell + 安装 php-build 插件实现多版本管理。
直接说结论：phpEnv 没有官方“安装包”可下载，所谓“phpEnv安装包”多是第三方打包的集成环境（如含 Apache、MySQL、PHP 多版本的 GUI 工具），和真正的 phpenv（命令行 PHP 版本管理器）不是一回事。你如果想要的是灵活、可复现、团队一致的多版本 PHP 管理，就别找 exe 或 dmg 安装包，老老实实走源码安装 + php-build 插件这条路。
为什么找不到可靠的 phpEnv 官方安装包
搜索“phpEnv 安装包”看到的大多是中文社区打包的集成套件（比如名字带“phpEnv for Windows”或“phpEnv 一键环境”），它们通常：
- 把 Apache/Nginx/MySQL/PHP 几个服务塞进一个 GUI 界面，底层不暴露
phpenv的 shims 和版本切换逻辑 - 预编译几个 PHP 版本，但无法自由增删、无法指定 configure 参数（比如加
--with-openssl）、无法升级补丁版本 - Windows 上常依赖
phpenv的非官方 fork（如phpenv-win），兼容性差，phpenv install基本不可用 - 这类工具的
.php-version文件识别、phpenv local切换在子 shell 或 CI 中经常失效
正确的安装路径：git clone + 配置 shell + 安装插件
标准 phpenv 是纯 Bash/Shell 工具，只管 PHP 二进制切换，不碰 Web 服务器。它必须从源码安装，并搭配 php-build 插件才能编译安装新版本：
- 克隆主仓库：
git clone https://gitcode.com/gh_mirrors/ph/phpenv.git ~/.phpenv - 配置 shell（以 Zsh 为例，改
~/.zshrc）：export PATH="$HOME/.phpenv/bin:$PATH"和eval "$(phpenv init -)" - 安装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 重载配置：
source ~/.zshrc（别用exec $SHELL -l，容易丢当前目录和环境变量） - 验证：
phpenv --version应输出类似phpenv 1.2.4
安装 PHP 版本时最容易卡住的三个点
phpenv install 8.3.13 看似一行命令，实际失败率很高，常见卡点：
立即学习“PHP免费学习笔记（深入）”；
- 系统缺编译依赖：Ubuntu/Debian 要先跑
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev；macOS 用brew install openssl@3 readline sqlite3 xz，再导出export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3" - 网络问题导致下载慢或中断：php-build 默认从 php.net 下载源码，国内建议提前设置镜像，比如
export PHP_BUILD_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/php - 权限或路径错误：不要用
sudo phpenv install；确保$(phpenv root)/versions可写，且磁盘剩余空间 > 2GB（编译过程临时文件很大）
项目级版本生效失败？检查 .php-version 文件和 rehash
执行了 phpenv local 8.3.13 却发现 php -v 还是旧版本，大概率是下面两个原因：
-
.php-version文件没生成或位置不对：该文件必须放在项目根目录（和composer.json同级），内容只能是8.3.13（不能带空格、不能有多余换行） - shim 没刷新：
phpenv install或phpenv local后，务必手动运行phpenv rehash，否则~/.phpenv/shims/php不会指向新版本 - 终端已缓存
php路径：运行hash -d php清除 bash/zsh 的命令哈希缓存，再试which php—— 正确结果应为~/.phpenv/shims/php
真正麻烦的不是安装步骤，而是每个系统环境里隐藏的依赖链和缓存机制。比如 macOS 上 OpenSSL 版本错位、Linux 上 /usr/bin/php 优先于 shims、CI 环境里 shell 初始化不完整——这些都不会报错，只会让 php -v 固定显示某个版本，怎么切都不动。动手前先 which php 和 phpenv version 对着看，比盲目重装有效得多。
