Windows用户应安装phpEnv.cn的图形化集成工具，而非GitHub的phpenv命令行工具；安装路径需无中文空格，须以管理员身份运行并注意端口与hosts配置。
直接装 phpEnv（Windows 下那个带 Apache/MySQL/PHP 一键集成的图形化工具）不是为了折腾，而是为了“开箱即用”。它和 phpenv（Linux/macOS 下命令行多版本管理工具）完全不是同一个东西——名字像，但用途、架构、安装方式全都不一样。选错方向，后面所有操作都会卡在第一步。
怎么确认你该装哪个 phpEnv？看系统和需求
如果你用的是 Windows，想快速跑起一个 PHP 站点（比如 ThinkPHP、Laravel 或纯 index.php），不需要频繁切换 PHP 版本，也不写 Shell 脚本——那就装官网的 phpEnv（www.phpenv.cn）。它本质是个绿色集成包，双击安装、点几下鼠标就能访问 localhost。
如果你用的是 macOS 或 Linux，需要在同一个系统里并存 PHP 7.4、8.1、8.3 并按项目自动切换——那你要的是 phpenv（GitHub 上的命令行工具），不是这个 phpEnv。强行在 Windows 上硬套 phpenv 的 git clone + eval "$(phpenv init -)" 流程，根本跑不起来。
- Windows 用户：认准
phpEnv.cn下载 exe 安装包，别去 GitHub 找phpenv - macOS/Linux 用户：直接跳过
phpEnv.cn，走phpenv+php-build路线 - 装完发现没有
phpenv命令？说明你下错了——那是phpEnv图形工具，压根不提供命令行入口
Windows 下 phpEnv 安装最容易卡住的三个地方
不是下载慢，也不是杀毒软件拦截，而是路径和权限问题最常导致服务启动失败或站点打不开。
立即学习“PHP免费学习笔记（深入）”；
- 安装路径必须不含中文、空格、特殊符号；推荐
D:\phpEnv，别放C:\Program Files\或桌面 - 首次运行要以管理员身份启动主程序，否则修改
hosts、绑定 80 端口会失败 - Apache 启动报红？先点控制面板里的「端口检测」，如果 80 被 Skype、IIS 或另一个 Apache 占了，就改 Apache 端口为
8080，然后访问http://localhost:8080 - MySQL 启动失败？大概率是之前装过 MySQL 服务冲突了，进「软件管理」里卸载旧版 MySQL 再试
添加站点后为什么 www.tp.com 打不开？
phpEnv 会自动往系统 C:\Windows\System32\drivers\etc\hosts 里加一行 127.0.0.1 www.tp.com，但这行不一定实时生效。
- 改完 hosts 后必须重启 phpEnv 主程序，不是只点「重启服务」
- 浏览器访问前清一下 DNS 缓存：
ipconfig /flushdns（Windows 命令行执行） - 如果用了代理或公司网络，可能 hosts 被绕过，临时换 Chrome 无痕窗口试试
- 确认站点根目录里真有
index.php，且不是空文件或 BOM 头导致白屏
真正麻烦的从来不是安装按钮点几下，而是路径权限、端口占用、hosts 生效时机这些看不见的链路。装完能打开 localhost 只算完成 30%，剩下 70% 是确保你加的每个站点都能被正确解析、路由、执行——而这部分，没人替你点鼠标。
