phpenv是类Unix系统专用的PHP版本管理工具，需Git克隆、配置PATH、启用shims并配合php-build插件编译安装PHP版本；Windows用户应使用PHPEnv集成环境（phpenv.cn），二者名称相似但功能、平台完全无关。
phpenv 不是开箱即用的“一键安装包”，它本质是 Shell 级的 PHP 版本管理工具，必须手动配置 PATH、初始化 shims、并配合 php-build 插件才能编译安装具体 PHP 版本。直接双击运行或扔进 C 盘 Program Files 会失败。
怎么装 phpenv 本体（不是集成环境）
你看到的“PHPEnv 官网下载 exe”是另一个叫 PHPEnv（带界面、Windows 专用、含 Apache/MySQL） 的集成套件，和命令行工具 phpenv 完全无关——别下错。真正的 phpenv 只支持类 Unix 系统（macOS / Linux），靠 Git 克隆 + Shell 配置驱动：
- 克隆到
~/.phpenv：git clone https://github.com/phpenv/phpenv.git ~/.phpenv - 写入环境变量（Bash 用户改
~/.bash_profile或~/.bashrc）：export PATH="$HOME/.phpenv/bin:$PATH" - 启用 shims 和补全：
eval "$(phpenv init -)" - 重载 Shell：
exec $SHELL -l - 验证：
phpenv --version能输出版本号才算成功
为什么装完 phpenv 还不能用 php 命令
phpenv 本身不提供任何 PHP 二进制文件，它只是个“调度员”。你必须先装 php-build 插件，再用它编译安装具体版本：
- 装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 查看可装版本：
phpenv install --list - 装一个（比如 8.2.12）：
phpenv install 8.2.12 - 关键一步：
phpenv rehash—— 否则php命令不会出现在 shims 路径里 - 设为全局默认：
phpenv global 8.2.12
此时再执行 php -v 才会显示版本。漏掉 rehash 是最常见卡点。
立即学习“PHP免费学习笔记（深入）”；
phpenv local 和 .php-version 文件怎么生效
项目级版本切换依赖 .php-version 文件，但它的行为容易被误解：
- 在项目根目录运行
phpenv local 7.4.33，会在当前目录生成.php-version，内容就是7.4.33 - 该文件只对当前目录及其子目录生效，且优先级高于
global - 注意：如果父目录也有
.php-version，它不会向上继承；每个目录独立判断 - 终端里执行
phpenv version显示带空格的 “7.4.33 (set by.php-version)” 才算真正命中 - 编辑器或 IDE（如 VS Code）启动的终端可能未加载 phpenv 初始化，需手动 source 或重启终端
Windows 下根本跑不了原生 phpenv
官方 phpenv 没有 Windows 支持。你在 Windows 上搜到的“phpenv 安装教程”，99% 指的是图形化集成环境 PHPEnv（官网 phpenv.cn），它自带 Apache+MySQL+PHP 多版本切换按钮，但和命令行 phpenv 无任何代码或设计关联。
- 想在 Windows 用命令行多版本管理？选
WSL2 + phpenv，或用docker启 PHP 容器 - 图省事直接开 Apache/MySQL？用 PHPEnv（.exe）更合适，但它不响应
phpenv命令 - 混用两者会导致路径冲突：比如把 PHPEnv.exe 安装在
C:\Program Files\PHPEnv，又试图在 PowerShell 里跑phpenv global，必然报 command not found
最关键的混淆点：名字像，功能不同，平台隔离。确认你要的到底是「Shell 工具」还是「Windows 集成面板」，再动手。
