phpEnv（带横线）是Windows图形化集成环境，含Apache+MySQL+PHP，类似XAMPP；phpenv（无横线）是命令行多版本管理工具，二者不互通，混淆将导致路径错、命令报错、版本切换失效。
phpEnv 不是“一键安装就能跑 PHP 项目”的开箱即用工具，它本质是 Windows 下的集成环境套件（含 Apache + MySQL + PHP），和 XAMPP、WAMP 类似；而 phpenv（无横线）才是类 pyenv 的多版本管理工具。混淆两者会导致路径错、命令报错、版本切不动。
phpEnv（带横线）：Windows 图形化集成环境，装完就开 Apache
你搜到的“phpEnv 一键下载”基本指向 phpenv.cn 提供的 Windows 安装包（如 v8.9.5），它自带图形界面、服务开关按钮、站点管理面板。这不是命令行工具，也不走 ~/.phpenv 目录。
- 安装路径必须避开中文、空格、
C:\Program Files—— 否则 Apache 启动失败或站点根目录解析异常 - 首次运行要勾选「高级设置」里的「新增站点后自动写入 hosts」和「保存站点后自动重启服务」，否则改了配置得手动点两次“重启”
- 默认 Apache 端口是 80，若被 Skype、IIS 或其他程序占用，启动会变红；此时进「配置 → 端口检测」换到 8080，再把浏览器地址从
http://localhost改成http://localhost:8080 - 它内置的 PHP 版本固定（如 v8.9.5 默认带 PHP 7.4 和 8.1），不支持像
phpenv install 8.3.13那样自由编译安装新版本
phpenv（无横线）：命令行多版本管理器，需手动配置 Shell
你在 GitHub、GitCode 上看到的 phpenv（如 https://gitcode.com/gh_mirrors/ph/phpenv）是纯 CLI 工具，只管 PHP 二进制切换，不管 Web 服务器或数据库。它不能直接启动 Apache，也不会弹出图形面板。
- 必须手动执行
git clone到~/.phpenv，然后往~/.bashrc或~/.zshrc写两行：export PATH="$HOME/.phpenv/bin:$PATH"和eval "$(phpenv init -)" - 运行
exec $SHELL -l后，phpenv --version有输出才算生效；如果还报command not found，大概率是 Shell 配置文件没 reload 或路径写错了 -
phpenv install命令依赖php-build插件，不装这个插件，所有 install 都会失败并提示phpenv: no such command `install` - 它不处理
php.ini路径自动映射——切换版本后，php --ini显示的配置文件路径仍是旧版本的，得手动确认或重装扩展
常见错误：为什么 phpenv local 8.1.0 没反应？
这是最典型的误用场景：你在 phpEnv（带横线）图形界面里建了个站点，又在终端里执行 phpenv local 8.1.0，结果 php -v 还是显示 7.4 —— 因为两个工具完全不互通。
立即学习“PHP免费学习笔记（深入）”；
- phpEnv（带横线）控制的是它自己打包的 Apache 子进程所用的 PHP，和你的终端 shell 无关
- phpenv（无横线）只影响当前 shell 会话的
$PATH，对 Apache 进程零影响 - 想让 Apache 用指定 PHP 版本，得去 phpEnv 的「软件管理」里下载对应版本，再进「环境设置」手动切换「默认 PHP 版本」下拉框
- 想在终端里验证某项目是否用了正确 PHP，别信
php -v，改用phpenv version-name查当前生效版本名，或which php看实际调用路径
真正容易被忽略的点是：图形化 phpEnv 和命令行 phpenv 解决的是两类问题——前者让你快速搭起一个能访问 http://localhost/test.php 的本地 Web 环境；后者让你在终端里安全地测试不同 PHP 版本的语法兼容性。混着用，八成卡在 php -v 和浏览器输出不一致上。
