phpenv本身仅为shell框架，需先克隆安装本体并配置PATH和init，再手动安装php-build插件及系统编译依赖，方可使用phpenv install安装PHP版本，之后才能通过phpenv global等命令管理版本。
直接设置默认 PHP 版本用 phpenv global，但前提是 PHP 版本已安装；而 phpenv 本身不提供预编译二进制，必须先装好 php-build 插件才能执行 phpenv install —— 这是绝大多数人卡住的第一步。
怎么下载和安装 phpenv 本体
它只是一个 shell 管理框架，不带任何 PHP 二进制文件：
- 运行
git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv（注意路径必须是~/.phpenv） - 把这两行加到
~/.zshrc或~/.bashrc末尾：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 执行
source ~/.zshrc（或对应配置文件），再运行phpenv --version验证是否识别命令
为什么 phpenv install 总报 command not found
因为 phpenv install 不是原生命令，它依赖 php-build 插件。没装这个插件，phpenv install 就不存在：
- 手动安装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 装完后执行
phpenv install --list才能看到可选版本（如8.3.13、7.4.33） - 某些系统缺编译依赖（如
autoconf、libxml2-dev、openssl-dev），会中途失败，错误信息通常是configure: error: unrecognized options或cannot find xml2-config
设置全局默认 PHP 版本的完整流程
不能跳过安装步骤直接 phpenv global x.x.x，否则 php 命令仍调用系统自带 PHP：
立即学习“PHP免费学习笔记（深入）”；
- 先装一个版本：
phpenv install 8.3.13（耗时较长，别误以为卡死） - 装完立刻执行：
phpenv global 8.3.13 - 新开终端或运行
phpenv rehash，再查php -v—— 此时才真正生效 - 注意：
phpenv global写入的是~/.phpenv/version文件，不是环境变量，所以只对启用 phpenv shims 的 shell 有效
项目级版本覆盖 global 的实际效果
phpenv local 生成的 .php-version 文件优先级高于 global，但容易被忽略的点是：
- 该文件内容只能写纯版本号，比如
8.2.15，不能带php-前缀或空格 - 如果项目目录里有
.php-version，但对应版本未安装，php命令会直接报错退出，不会 fallback 到 global -
phpenv shell 8.1.0是临时会话级切换，关闭终端即失效，适合做兼容性测试，但别误当持久配置用
最常被跳过的环节是插件安装和编译依赖准备——没它们，phpenv install 根本跑不起来，后续所有版本设置都只是空谈。
