phpEnv 是 Windows 图形化集成环境（类似 XAMPP），而 phpenv 是 macOS/Linux 命令行多版本管理工具，二者完全不同；Windows 用户应从 https://www.phpenv.cn/ 下载 phpEnv，macOS/Linux 用户需通过 GitHub 安装 phpenv 并配置依赖。
phpEnv 不是官方 PHP 项目，也不是 PHP 官方推荐的版本管理工具；它实际是 Windows 平台上的**集成环境套件（类似 XAMPP/WampServer）**，带图形界面、一键启停服务、多 PHP 版本切换功能，和类 Unix 下的 phpenv（纯命令行、需编译）完全不是同一个东西。混淆这两者会导致安装失败或行为异常。
确认你要的是 Windows 图形化 phpEnv 还是 Linux/macOS 命令行 phpenv
这是最关键的前置判断：
- 如果你用的是 Windows，想点几下就跑起 Apache + PHP + MySQL，还带控制面板——你该下载官网的
phpEnv（注意大小写，首字母小写 p） - 如果你用的是 macOS 或 Linux，需要在终端里用
phpenv install 8.3.13切换不同编译版 PHP——你该装的是开源项目phpenv（GitHub 上的phpenv/phpenv），不是 Windows 那个 phpEnv - Windows 下装 GitHub 上的
phpenv会失败：它依赖git、make、gcc，Windows 默认没有这些，且不支持shims机制
Windows 用户：从官网下载 phpEnv（非 GitHub）
官方下载地址是 https://www.phpenv.cn/（注意域名后缀是 .cn），不是 GitHub 或 GitCode。其他所谓“镜像站”或“GitHub fork”多数已停止更新或夹带风险。
- 不要访问
https://github.com/phpenv/phpenv下载 Windows 版 —— 那是给 macOS/Linux 用的 - 安装包约 200MB+，解压后是一个绿色文件夹，无需“安装程序”，直接运行
phpenv.exe即可启动控制面板 - 默认安装路径建议避开
C:\Program Files或含中文/空格的路径，例如D:\phpenv - 首次启动时会提示“初始化环境”，勾选“自动写入 hosts”和“保存站点后自动重启服务”，能省去手动配虚拟主机的麻烦
macOS / Linux 用户：正确安装 phpenv（注意拼写和依赖）
别搜“phpEnv 安装教程”，搜 phpenv install 或 php-build 才对。常见失败原因不是步骤错，而是漏了底层依赖：
立即学习“PHP免费学习笔记（深入）”；
- 必须先装好
git、autoconf、openssl-devel（CentOS/RHEL）或libssl-dev（Ubuntu/Debian）、libxml2-dev、zlib1g-dev - 克隆仓库路径必须是
~/.phpenv（不是~/phpenv），否则phpenv init生成的 shim 路径会错 -
phpenv install命令本身不自带编译能力，需额外装插件：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 安装 PHP 前务必执行
phpenv rehash，否则新装的版本不会出现在phpenv versions列表里
容易被忽略的路径和权限细节
无论哪个平台，最常卡住的地方都在路径和权限上：
- Windows phpEnv 的
php.ini实际位置在D:\phpenv\php\php-8.3.13\php.ini（版本号随你选），改配置前先确认你当前启用的是哪个 PHP 版本 - macOS/Linux 下如果
php -v仍显示系统自带 PHP，说明~/.phpenv/shims没进PATH，检查echo $PATH是否包含该路径 - Linux 上编译 PHP 失败报
configure: error: Cannot find OpenSSL's <evp.h>，不是没装 openssl，而是没装openssl-devel（开发头文件包） - 所有配置写入的 shell 文件（
~/.bash_profile或~/.zshrc）必须与你当前 shell 一致，Zsh 用户写进.bash_profile是无效的
