phpEnv（大写E）是Windows专用图形化PHP集成环境，支持Apache/Nginx/MySQL一键启停；phpenv（全小写）是Linux/macOS命令行PHP版本管理工具，仅切换PHP二进制，两者平台、架构、功能完全不兼容。
直接说结论：你看到的 phpEnv（带大写 E）和 phpenv（全小写）是两个完全不同的东西——前者是 Windows 上的图形化集成环境，后者是类 Unix 系统上的 Shell 版本管理工具。搞混它们，90% 的安装会失败或行为异常。
区分 phpEnv 和 phpenv：Windows GUI 和 Linux/macOS CLI 不兼容
很多人搜“phpEnv 安装”，结果在 macOS 或 Ubuntu 上照着 Windows 教程敲命令，phpenv 报错、phpEnv 根本打不开。关键区别如下：
-
phpEnv：Windows 专用，官网是phpenv.cn，带图形界面、Apache/MySQL/Nginx 一键启停，安装包约 200MB，双击安装即可 -
phpenv：Linux/macOS 专用，纯命令行，用 Git 克隆 + Shell 配置，不带 Web 服务，只管 PHP 二进制切换 - 两者配置文件、命令语法、路径结构、依赖项全部不通用——
phpenv local 8.3.13在 WindowsphpEnv下无效；phpEnv的“软件商店”在终端里也不存在
Windows 用户装 phpEnv：下载、安装、启动三步到位
如果你用的是 Windows，并且需要 Apache + PHP + MySQL 一起跑起来（比如本地调试 ThinkPHP、WordPress），就该用 phpEnv：
- 去
phpenv.cn/download.html下载最新安装包（截至 2026 年 4 月是 v8.9.5），不要从 GitHub 手动 clone - 右键以“管理员身份运行”安装程序，路径建议选
C:\phpEnv（避免中文或空格路径导致 Apache 启动失败） - 安装完勾选“启动服务”，首次运行会自动弹出防火墙提示，点“允许访问”
- 浏览器打开
http://localhost，能看到 PHP 探针页，说明 Apache + PHP 已就绪；http://localhost/phpmyadmin能进 MySQL 管理页，说明 MySQL 正常
macOS/Linux 用户别碰 phpEnv：该用 phpenv + php-build
如果你在终端里敲 phpenv --version 提示 command not found，不是没装对，而是你误用了 Windows 工具名。正确路径是：
立即学习“PHP免费学习笔记（深入）”；
- 克隆仓库：
git clone https://github.com/phpenv/phpenv.git ~/.phpenv - 配置 shell（以 zsh 为例）：
echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.zshrc，再加一行echo 'eval "$(phpenv init -)"' >> ~/.zshrc - 重载：
source ~/.zshrc，然后验证phpenv --version有输出 - 装插件才能编译 PHP：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 装版本前先装系统依赖（Ubuntu）：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev
常见故障点：which php 和 rehash 最容易被忽略
即使 phpenv install 8.3.13 成功，php -v 还是显示系统自带的老版本？问题大概率出在这两处：
- 执行
which php，如果返回/usr/bin/php或/opt/homebrew/bin/php，说明phpenv的 shim 没生效——检查~/.phpenv/shims是否在$PATH最前面，且eval "$(phpenv init -)"确实执行了 - 每次
phpenv install后必须手动phpenv rehash，否则新版本的php命令不会出现在 shims 目录里，shell 就找不到它 - 项目级切换用
phpenv local 8.3.13，但当前目录下必须存在.php-version文件（它会自动生成），删掉这个文件就退回到全局版本
