phpenv install 命令无法运行是因为缺少 php-build 插件，需先执行 git clone https://github.com/php-build/php-build.git ~/.phpenv/plugins/php-build 安装插件，再运行 phpenv rehash，否则提示“command not found: phpenv-install”。
phpenv install 命令无法运行？先确认 php-build 插件已安装
直接执行 phpenv install 8.3.13 报错 “command not found: phpenv-install” 是最常见问题。phpenv 本身不带编译能力，必须依赖 php-build 插件才能安装 PHP 版本。
- 插件路径必须是
$(phpenv root)/plugins/php-build，克隆时不能写错目标目录 - 推荐命令：
git clone https://github.com/php-build/php-build.git ~/.phpenv/plugins/php-build - 装完插件后，
phpenv install --list才能显示可用版本；否则只会提示“no such command” - macOS 用户注意：若用 Homebrew 安装了 OpenSSL 或 libxml2，需提前设环境变量，否则编译会失败
安装 PHP 扩展（如 xdebug、redis）该用 pecl 还是源码编译？
phpenv 管理的每个 PHP 版本都独立，扩展必须针对当前激活版本单独安装。优先用 pecl，但要注意它默认调用的是系统全局 PHP 的 pecl，不是 phpenv 当前版本。
- 先确认当前生效版本：
phpenv version，再用which pecl检查路径是否在~/.phpenv/versions/8.3.13/bin/pecl下 - 如果
pecl路径不对，手动指定：~/.phpenv/versions/8.3.13/bin/pecl install xdebug - 某些扩展（如
grpc、protobuf）需要额外依赖，Ubuntu/Debian 上要先装sudo apt-get install -y pkg-config build-essential - 装完扩展后，必须手动编辑对应版本的
php.ini（路径如~/.phpenv/versions/8.3.13/etc/php.ini），加入extension=xdebug.so
下载 phpenv 该用哪个仓库？别被镜像坑了
官方主仓库早已迁至 https://github.com/phpenv/phpenv，但很多中文教程仍指向过期的 gitcode 镜像（如 gh_mirrors/ph/phpenv）。这些镜像同步滞后，缺少最新 commit 和 issue 修复。
- 正确克隆命令：
git clone https://github.com/phpenv/phpenv.git ~/.phpenv - 若已克隆旧镜像，可进
~/.phpenv目录执行：git remote set-url origin https://github.com/phpenv/phpenv.git && git pull - 不推荐用
phpenv-installer脚本——它早已停止维护，最后更新是 2021 年，且硬编码了失效的 URL - 验证是否为活跃仓库：检查
~/.phpenv/.git/config中的 origin URL 是否指向 github.com/phpenv/phpenv
phpenv local 设置后扩展不加载？检查 .php-version 文件位置和格式
项目级版本切换靠 .php-version 文件触发，但它只在当前目录或父目录存在时才生效，且文件内容不能带空格或换行符。
立即学习“PHP免费学习笔记（深入）”；
- 文件必须放在项目根目录（即执行
phpenv local 8.3.13的那个目录），不是src/或public/ - 文件内容只能是纯版本号，例如
8.3.13，不能是v8.3.13或8.3.13\n - 如果用了
phpenv shell 8.3.13临时切换，退出终端后设置即失效，不会影响.php-version - 执行
phpenv rehash后，所有 shim（如php、pecl）才会重新链接到新版本路径——这步漏掉，php -v就永远不变
rehash 的触发时机。很多人装完 php-build 就急着 phpenv install，结果报错；或者改了 .php-version 就以为自动生效，却忘了 rehash ——这两步卡住，后面所有扩展和版本切换都会失灵。 
