phpEnv（Windows图形工具）与phpenv（Linux/macOS命令行工具）完全不兼容：前者需手动解压重命名配置NTS版PHP并设绝对路径，后者依赖php-build插件编译且须执行rehash。
直接说结论：phpEnv（注意大小写，不是 phpenv）是 Windows 下的图形化 PHP 环境管理工具，它不支持通过命令行安装或编译 PHP，所谓“自定义版本”实际是手动解压 + 重命名 + 配置三步操作；而 Linux/macOS 下的 phpenv（全小写）是命令行工具，依赖 php-build 插件才能编译安装，两者完全不兼容，混用会导致路径错乱、命令失效。
确认你用的是哪个 phpEnv
这是最容易踩坑的第一步。Windows 用户搜到的“phpEnv”通常是带界面的绿色软件（官网已下线，现多为第三方镜像），其目录结构固定，比如：C:\phpEnv\php\php-8.2.12；而 macOS/Linux 用户装的 phpenv 是纯 CLI 工具，路径在 ~/.phpenv/versions/8.2.12。如果你在 Windows 上执行 phpenv install 或在终端里看到 command not found: phpenv，基本就是搞混了工具链。
Windows phpEnv 手动添加 PHP 版本（NTS + VC 运行时）
必须用 NTS（Non-Thread-Safe） 版本，且 VC 运行时要匹配。PHP 官网归档页（https://windows.php.net/downloads/releases/archives/）下载后，按以下顺序操作：
- 解压 ZIP 到
C:\phpEnv\php\目录下，重命名为php-8.2.12（格式必须是php-主版本.次版本.修订号，不能带字母或空格） - 进入该文件夹，复制
php.ini-development→ 改名为php.ini - 编辑
php.ini，必须设置两项绝对路径（相对路径会失败）：upload_tmp_dir = "C:/phpEnv/temp/php/"session.save_path = "C:/phpEnv/temp/php/" - 确保
C:/phpEnv/temp/php/目录存在且有写权限 - 关闭 phpEnv 软件，再重新打开，新版本才会出现在“PHP 版本”下拉列表中
Linux/macOS 下想装非官方源的 PHP 版本？别用 phpenv 直接编译
phpenv 本身不提供编译能力，它只是版本路由层；真正干活的是 php-build 插件。但手动编译 PHP 极易失败——缺依赖、openssl 版本冲突、--with-ldap 找不到头文件都是常态。更现实的做法是：
立即学习“PHP免费学习笔记（深入）”；
- 优先用系统包管理器安装（如 Ubuntu 的
apt install php8.2-cli），再用phpenv local 8.2指向它（需配置PHPENV_ROOT和 shim 路径） - 若必须自定义编译，先装好
php-build：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 设置构建参数再安装：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/usr/local/opt/openssl@3"，然后运行phpenv install 8.2.12 - 安装完立刻执行
phpenv rehash，否则php命令仍指向旧版本
最常被忽略的一点：Windows phpEnv 的 .php-version 文件无效，它只认界面下拉选择；而 phpenv（小写）完全不认 Windows 的路径分隔符和驱动器号——跨平台脚本里硬写 C:\ 会直接报错。
