phpenv是类Unix系统下小写命令行PHP多版本管理工具，非Windows图形化PHPEnv；需git clone、配置PATH与init、重载shell、验证版本四步缺一不可。
直接用 git clone 下载，别去搜“phpEnv下载页”或“Windows安装包”——那不是这个工具。
phpenv 不是 Windows 一键安装包，而是类 Unix 环境下的版本管理器
你看到的“PHPEnv”带大写 E、有官网下载链接、支持 Apache/MySQL 一键启停的，是另一个叫 PHPEnv 的 Windows 集成环境（类似 XAMPP）。而真正用于多版本 PHP 切换、命令行驱动、被广泛用于 macOS/Linux 开发和 CI 的，是小写的 phpenv（GitHub 上由 phpenv 组织维护）。
混淆这两者，会导致：装错工具、命令不识别、phpenv install 报错、甚至误删系统 PHP。
- ✅ 正确目标：终端里能执行
phpenv versions、phpenv install 8.3.13 - ❌ 错误操作：双击 exe 安装、在 Windows 控制面板里找服务、期待图形界面
下载与初始化：四步必须全做，缺一不可
只克隆代码不配置 shell，phpenv 就是个死目录；只改 PATH 不运行 init，shims 不生效，php 命令仍调用系统默认版本。
立即学习“PHP免费学习笔记（深入）”；
- 克隆到用户目录：
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv - 追加两行到 shell 配置文件（
~/.bashrc或~/.zshrc）：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 重载配置：
source ~/.zshrc（zsh 用户）或source ~/.bashrc（bash 用户） - 验证：
phpenv --version应输出版本号；which php应指向~/.phpenv/shims/php，而非/usr/bin/php
安装 PHP 版本前，先装依赖和插件
phpenv install 实际调用的是 php-build 插件，它需要编译源码。没装依赖就跑 install，大概率卡在 configure 阶段，报错如 configure: error: Cannot find OpenSSL's <evp.h></evp.h> 或 libxml2 not found。
- 先装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - Ubuntu/Debian：
sudo apt install build-essential libssl-dev libxml2-dev libsqlite3-dev libcurl4-openssl-dev libpng-dev libjpeg-dev libfreetype6-dev - macOS（Homebrew）：
brew install openssl@3 libxml2 sqlite3 curl jpeg pngquant freetype，再导出环境变量：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl@3 --with-sqlite3=/opt/homebrew/opt/sqlite3"
切换版本失败？先看 .php-version 文件是否干扰
phpenv local 8.3.13 会在当前目录生成 .php-version，内容就是 8.3.13。但这个文件一旦存在，就会**优先于 global 和 shell 设置**，且不会自动删除。
- 现象：执行
phpenv global 7.4.33后php -v还是 8.3.13 → 检查当前目录是否存在.php-version - 临时绕过：
phpenv shell 7.4.33（仅当前终端生效） - 彻底清除项目级锁定：
rm .php-version，再phpenv rehash - 注意：Git 默认不跟踪该文件，团队协作时需手动加入
.gitignore或明确提交，否则容易引发版本混乱
最常被跳过的其实是 phpenv rehash —— 它负责重建所有 shims 链接。安装新版本、删掉旧版本、甚至改了插件后，不运行这句，php 命令可能根本找不到二进制文件。
