phpenv（小写、无空格、GitHub开源）是PHP版本管理工具，靠shell shim切换CLI版本；phpEnv（大写P、带空格、phpenv.cn）是Windows图形化集成环境，含Apache/MySQL，二者完全无关，混用会导致PATH冲突、命令失效及Composer协作异常。
phpEnv 没有官方下载安装包，所谓“phpEnv纯净版”是第三方打包的集成环境，不是 phpenv（PHP 版本管理工具）本身。 这个混淆已经导致大量用户装错工具、路径冲突、后续无法切换版本或与 Composer 协同工作。下面直接说清楚怎么做、为什么、以及最容易卡住的地方。
区分 phpenv 和 phpEnv：名字像，但完全不是一回事
phpenv（小写 p、无空格、GitHub 开源项目）是一个类 rvm / pyenv 的命令行 PHP 版本管理器，靠 shell shim 机制切换 php 命令指向。它不带 Web 服务、不带 MySQL、不改 hosts、也不开本地服务器。
phpEnv（大写 P、带空格、域名 phpenv.cn）是国产 Windows 集成包，把 Apache、PHP、MySQL、phpMyAdmin 打包进一个图形界面，类似 XAMPP。它内部可能调用某个 PHP 版本，但不支持 phpenv install 或 phpenv local 等操作。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 在终端输入
phpenv --version报错command not found，但双击 phpEnv.exe 能打开界面 → 你装的是 phpEnv，不是 phpenv - 按教程执行
phpenv install 8.2.12失败，提示No such command `install`→ 缺少php-build插件，或根本没装对项目 - Windows 上装了 phpEnv 后，再想用 phpenv 管理 CLI 版本，结果
php -v始终显示 phpEnv 自带的版本 → PATH 冲突，且 phpEnv 修改了系统级环境变量
Windows 下想用真正的 phpenv？别走下载安装包的路
phpenv 官方不提供 Windows 安装包，也不原生支持 Windows（Git Bash / WSL 是可行路径）。所谓“phpEnv 官方下载站（phpenv.cn）”和 phpenv 项目无任何代码、作者、仓库关联。
如果你需要多版本 PHP CLI 支持（比如跑 PHPUnit、Laravel Dusk、Composer require），推荐以下真实可用路径：
- 用
WSL2 + Ubuntu：在微软商店装 WSL2，然后按 GitHub 上phpenv/phpenv的标准流程走 ——git clone、export PATH、phpenv install - 用
Git Bash（非 CMD/PowerShell）：能跑部分 phpenv 功能，但需手动装php-build依赖（如autoconf、openssl-devel），编译失败率高 - 放弃 phpenv，改用
docker run --rm -v $(pwd):/app -w /app php:8.2-cli php script.php：对单次 CLI 执行更轻量、无环境污染
注意：phpenv-installer 脚本在 Windows Git Bash 下大概率卡在 curl 或权限阶段，不建议硬试。
phpEnv（phpenv.cn）安装后最常踩的三个坑
如果你明确就要用 phpEnv（即图形化集成环境），那这些点必须手动干预，否则开发体验极差：
- 默认把 PHP 加入系统 PATH，导致终端里
php -v总是返回它的版本，掩盖你用其他方式安装的 PHP → 进入“软件设置 → 环境设置”，关掉“将 PHP 加入系统环境变量” - 新建站点后自动写
hosts，但只加127.0.0.1 mysite.test，没配 HTTPS 或泛解析 → 浏览器访问报 DNS 错误时，先检查 hosts 是否真生效（ping mysite.test）、再确认 Apache 是否监听 80 端口（netstat -ano | findstr :80） - 自带的 PHP 不含
pdo_sqlite或mbstring扩展，运行 Laravel 或 Symfony 直接报错 → 进入 phpEnv 安装目录下的php/ext/看扩展是否存在，再编辑对应php.ini取消注释extension=mbstring行，并重启服务
真正麻烦的从来不是装上，而是搞清你到底要什么：是命令行下自由切换 PHP 版本（选 phpenv + WSL），还是开箱即用搭个本地网站（选 phpEnv 但得会修配置）。两者混着用，99% 会互相覆盖 PATH、php.ini 路径、甚至 openssl 配置。动手前先问自己一句：接下来三天我要调试 Composer 插件，还是要把 WordPress 丢进去跑？答案决定了该删哪个、留哪个。
