phpenv通过shims机制动态路由php命令，而非手动替换二进制；支持global（全局）、local（项目级）和shell（会话级）三级版本切换，优先级为shell＞local＞global，依赖正确初始化（eval "$(phpenv init -)"）和PATH配置。
phpenv 切换 PHP 版本不是“手动替换二进制”，而是靠 shims 机制动态路由命令调用——只要配置正确，php 命令每次执行时都会被重定向到当前生效版本的真正可执行文件。
phpenv global 设置全局默认版本
这是最直接的切换方式，影响所有未指定本地版本的目录：
-
phpenv global 8.3.13会把系统级默认版本设为 8.3.13；之后在任意目录运行php -v都显示该版本 - 若目标版本尚未安装，命令会失败并提示 “no such version”，必须先用
phpenv install 8.3.13 - 执行后不会立即刷新
php -v输出？检查是否漏掉eval "$(phpenv init -)"初始化，或终端未重新加载配置（source ~/.bashrc） - 全局设置写入的是
~/.phpenv/version文件，可直接查看或编辑（不推荐手改，用命令更安全）
phpenv local 在项目目录绑定版本
适合多项目共存场景，进入目录即自动切换，离开即恢复全局版本：
- 在项目根目录执行
phpenv local 7.4.33，会在当前目录生成.php-version文件，内容就是7.4.33 - 该文件会被 Git 跟踪，团队协作时能保证环境一致；但注意不要误提交测试用的临时版本号
- 如果子目录也有
.php-version，优先级高于上级目录，但一般不建议嵌套使用 - 想取消本地绑定？删掉
.php-version或执行phpenv local --unset
phpenv shell 临时覆盖当前终端会话
用于快速验证、调试或 CI 流水线中单次任务，不影响其他终端或全局设置：
立即学习“PHP免费学习笔记（深入）”；
-
phpenv shell 5.6.40会让当前 shell 中所有php调用都指向 5.6.40，直到关闭终端或执行phpenv shell --unset - 它通过设置环境变量
PHPENV_VERSION实现，所以新开一个终端不会继承 - 和
global冲突时，shell>local>global，顺序不可逆 - CI 脚本里常用：避免污染全局状态，任务结束自然失效
常见失效原因与验证方法
切换后 php -v 不变？大概率是 shims 没生效或路径冲突：
- 确认
which php输出的是~/.phpenv/shims/php，而不是/usr/bin/php或 Homebrew 的路径；否则说明 PATH 未正确前置 - 运行
phpenv version查看当前激活版本及来源（比如 “7.4.33 (set by.php-version)”），比php -v更可信 - 检查
phpenv versions是否有星号标记当前版本；没星号说明未激活任何已安装版本 - Mac 上用了 Homebrew 或 MAMP？它们的
php可能霸占 PATH，需确保~/.phpenv/bin和~/.phpenv/shims在 PATH 最前面
真正麻烦的不是切换动作本身，而是 shims 依赖 shell 初始化完整生效——哪怕只漏掉一行 eval "$(phpenv init -)"，整个机制就形同虚设。建议每次配置完都用 which php 和 phpenv version 双重确认。
