phpenv是类rbenv的命令行PHP版本管理工具，支持多版本共存、项目级自动切换及CI/CD一致；PHPEnv则是Windows图形化集成环境，不支持新版PHP及语义化切换。
phpenv 不是 PHPEnv —— 这是两个完全不同的工具，名字像、用途有重叠，但底层机制和适用场景截然不同。搞混它们会导致配置失败、命令报错、版本切不动，甚至误删本地 PHP 环境。
你搜到的“phpEnv下载安装视频教程”“phpEnv快速入门手册”，大概率指向 Windows 下那个带图形界面、集成 Apache/MySQL 的一键包（官网已多年未更新，最新版停留在 PHP 7.4）。而真正支持多版本、项目级切换、类 rbenv/pyenv 设计哲学的，是开源社区维护的命令行工具 phpenv（无大写 E，无 GUI，纯终端驱动）。
下面直说怎么用对、怎么避坑：
确认你要的是 phpenv 还是 PHPEnv
如果你需要：
• 在同一台机器上并行跑 PHP 7.4、8.2、8.3、8.4
• 每个项目自动读取 .php-version 切换解释器
• 和 CI/CD 流水线保持 PHP 版本一致
→ 你应该用 phpenv，不是 PHPEnv。
如果你只是想在 Windows 上点几下就跑起一个 localhost 网站，不关心版本管理、不写自动化脚本、不用命令行部署 → PHPEnv（Windows GUI 版）可能更省事，但它无法安装 PHP 8.3+，也不支持 phpenv local 这类语义化切换。
phpenv 安装后 phpenv 命令不存在？检查 PATH 和 shell 初始化
常见现象：
• 执行 git clone 成功，~/.phpenv 目录存在
• 但输入 phpenv --version 提示 command not found
根本原因：shell 没加载 phpenv init 注入的 shim 机制。
实操建议：
• 确认你编辑的是当前 shell 正在读的配置文件（bash 用户通常是 ~/.bashrc 或 ~/.profile；zsh 用户是 ~/.zshrc）
• 两行必须都写进去：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)"
• 写完后不要只 source ~/.bashrc，要彻底重启终端或执行 exec $SHELL -l（-l 表示 login shell，确保加载完整环境）
• 验证：运行 which phpenv 应该返回 ~/.phpenv/bin/phpenv，而不是空
装了 php-build 插件却提示 phpenv install 未找到？
phpenv 本身不提供编译能力，install 命令来自插件 php-build。没装它，phpenv install 8.3.13 就会报错。
关键步骤：
• 克隆插件到正确路径：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
• 注意：不能放在 ~/.phpenv/plugins/ 外的任意位置，$(phpenv root) 必须展开为实际路径（通常是 ~/.phpenv）
• 装完插件后，必须运行 phpenv rehash —— 否则新命令不会被 shim 系统识别
• 编译前建议先装依赖（Ubuntu/Debian）：sudo apt install autoconf bison build-essential libssl-dev libxml2-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev libicu-dev libzip-dev，缺依赖会导致 configure 失败，错误信息里常含 configure: error:
为什么 phpenv local 8.3.13 后 php -v 还是旧版本？
这不是 bug，是 phpenv 的工作逻辑决定的：
• phpenv local 只在当前目录及子目录生效，且依赖 shell 的 pwd 实时判断
• 如果你用 cd 进入的是软链接目录（比如 ln -s ~/projects/a ~/a），phpenv 默认按物理路径匹配，找不到 .php-version
• 更隐蔽的问题：某些终端（如 VS Code 内置终端）启动时 pwd 是 / 或 $HOME，即使你 cd 进了项目，shim 仍可能缓存旧路径
解决办法：
• 进入项目根目录后，手动运行 phpenv local 8.3.13（确保当前 pwd 是真实路径）
• 检查是否生成了 .php-version 文件：cat .php-version 应输出 8.3.13
• 运行 phpenv version（注意是 version，不是 versions）看当前解析结果
• 若仍不对，执行 phpenv rehash 强制刷新 shim 映射
立即学习“PHP免费学习笔记（深入）”；
phpenv 的核心复杂点不在安装，而在它的三层作用域（global / local / shell）与 shell shim 机制的耦合。一旦路径解析、配置加载、插件注册中任一环断开，就会表现为“命令存在但无效”“版本设了却不生效”。最稳妥的做法是：每次配置变更后，用 which php + phpenv version + cat .php-version 三者交叉验证，而不是只信 php -v 输出。 
