phpEnv（大写E）是Windows图形化集成环境，phpenv（全小写）是类Unix系统PHP版本管理工具；前者双击运行、界面切换版本，后者需Git克隆、Shell配置并支持多版本共存与项目级切换。
phpEnv 不是 phpenv——这是最容易踩的第一个坑。你搜到的“phpEnv”（带大写 E，域名 phpenv.cn）和开发者常用的 phpenv（全小写，GitHub/GitCode 上的开源项目）是两个完全不同的东西：前者是 Windows 下的图形化集成环境（类似 PHPStudy），后者是类 Unix 系统下用 Shell 编写的多版本 PHP 管理工具。配置方式、适用平台、命令语法全部不兼容。
怎么确认自己要的是哪个 phpEnv？
看使用场景：
- 你在 Windows 上双击安装包，点“启动 Apache”“切换 PHP 版本”按钮 → 那是 phpEnv（phpenv.cn），它不提供命令行
phpenv命令，也不读.php-version文件 - 你在 macOS/Linux 终端里敲
phpenv install 8.2.12或phpenv global 7.4.33→ 那是phpenv，必须用 Git 克隆 + Shell 配置，不提供 GUI
二者下载地址、安装逻辑、甚至 PHP 二进制路径都完全不同，混用会导致 command not found 或 PHP version mismatch 这类错误。
phpenv（小写）怎么装？别用 phpenv-installer
官方推荐的手动安装更稳定，phpenv-installer 脚本在较新系统（尤其是 macOS Sonoma+ 或 Ubuntu 24.04）上常因权限或 OpenSSL 版本报错：
立即学习“PHP免费学习笔记（深入）”；
- 运行
git clone https://github.com/phpenv/phpenv.git ~/.phpenv - 往
~/.bash_profile（macOS）或~/.bashrc（Linux）追加两行：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 执行
source ~/.bash_profile（或对应文件），再运行phpenv --version验证 - 必须手动安装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build，否则phpenv install会失败
phpenv 安装 PHP 版本时常见失败原因
不是网络慢，而是依赖缺失或环境变量没设对：
-
configure: error: no acceptable C compiler found in $PATH→ 没装 Xcode Command Line Tools（macOS）或build-essential（Ubuntu/Debian） -
ERROR: failed to download openssl→ 系统 OpenSSL 太新，需加编译参数：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/usr/local/opt/openssl@3"（macOS Homebrew） -
phpenv install 8.3.13卡住 → 默认用源码编译，耗时长且易出错；可改用预编译包（需提前配置PHPENV_ROOT并启用php-build插件） - 装完后
php -v仍显示旧版本 → 检查是否漏了phpenv rehash，或~/.phpenv/shims没在 PATH 最前面
phpEnv（大写，phpenv.cn）怎么下载和基本配置？
它只支持 Windows，官网 http://www.phpenv.cn 提供单个安装包，下载后解压即用：
- 运行
phpenv.exe，界面左上角“PHP版本”下拉菜单可切换已内置的 PHP（如 7.2.34、8.0.28、8.1.23） - 切换后点“应用设置”，Apache/Nginx 会自动重启，
phpinfo()显示的版本随之更新 - 不支持自定义编译选项，不能装 PECL 扩展（如
xdebug需手动复制 DLL 到ext/并改php.ini） - 项目目录里放
.php-version文件无效 —— 它不识别这个约定，只认界面操作
如果你在团队协作中需要跨平台一致的 PHP 版本管理，或者得跑 CI 流程、写自动化脚本，phpenv（小写）才是正解；图省事、纯本地 Windows 开发，phpEnv（大写）能快速上手，但灵活性和可复现性差很多。
