phpenv仅识别通过phpenv install构建并置于~/.phpenv/versions/下的php版本，不支持手动挂载外部php目录；其版本切换依赖shell>local>global优先级，每次只激活一个版本，通过shim代理动态路由到对应bin/php。
phpenv 本身不支持“添加多个 PHP 目录”这种手动挂载方式——它只认自己编译安装的版本，所有 PHP 二进制文件必须由 phpenv install 构建并置于 ~/.phpenv/versions/ 下，否则 phpenv 不会识别、也无法切换。
phpenv install 安装的每个版本自动对应一个独立目录
你不需要、也不应该手动复制或链接外部 PHP 目录进去。每次运行 phpenv install 8.3.13，phpenv 就会在 ~/.phpenv/versions/8.3.13/ 创建完整隔离的安装树（含 bin/php、lib/、etc/ 等）。这个路径就是它唯一认可的“PHP 目录”。
- 手动把系统自带的
/usr/bin/php或 Homebrew 的/opt/homebrew/bin/php软链进~/.phpenv/versions/不起作用——phpenv启动时会校验configure参数和构建元数据，非本源构建的二进制会被跳过 - 如果你已有预编译的 PHP 包（如从 windows.php.net 下的 zip），不能直接用；必须用
php-build插件配合phpenv install重编译一遍 -
phpenv versions列出的，全是~/.phpenv/versions/下通过install成功完成的子目录，一个都不能少文件，否则显示为灰色或报错
多版本切换依赖层级优先级，不是“同时启用”
phpenv 不是并发加载多个 PHP，而是按固定顺序决定当前生效的版本：shell > local（.php-version） > global。它只激活一个版本，但能快速切换。
-
phpenv shell 7.4.33：仅当前终端有效，退出即失效，适合临时测试 -
phpenv local 8.2.15：在当前目录写入.php-version，进入该目录时自动激活，子目录继承（除非被更下层的.php-version覆盖） -
phpenv global 8.3.13：作为兜底版本，当没找到 local 或 shell 设置时才生效 - 执行
phpenv version可看到当前生效版本 + 来源（比如8.2.15 (set by /path/to/project/.php-version)）
phpenv which php 显示的是 shim 路径，不是真实二进制
当你运行 php 命令时，实际调用的是 ~/.phpenv/shims/php 这个代理脚本，它根据当前环境动态转发到对应版本的 bin/php。所以 phpenv which php 返回的是 shim 路径，而 phpenv which php | xargs ls -l 才能看到最终指向的真实二进制位置。
- 不要直接修改或替换
~/.phpenv/shims/下的文件，这会导致所有版本切换失效 - 如果
php -v和phpenv version不一致，大概率是PATH里有其他 PHP 路径（如/usr/local/bin）排在~/.phpenv/shims前面，用echo $PATH检查顺序 - 每次新安装版本后，务必运行
phpenv rehash，否则 shim 不会更新，php命令仍指向旧版本
真正容易被忽略的点是：phpenv 的“版本”概念绑定的是完整构建产物，不是任意可执行文件；它的切换逻辑完全依赖 shell 层级和文件系统路径，没有后台进程或守护服务——这意味着一旦你绕过 shim（比如直接调用 ~/.phpenv/versions/8.3.13/bin/php），就彻底脱离了 phpenv 的管理范围。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
