phpenv命令找不到的根源是PATH未包含~/.phpenv/bin且未执行phpenv init -；必须将export PATH="$HOME/.phpenv/bin:$PATH"和eval "$(phpenv init -)"写入shell配置文件并source生效。
phpenv 命令找不到？PATH 和 init 是关键
安装完 phpenv 后执行 phpenv --version 报错 command not found，90% 是环境变量没生效。不是克隆错了，也不是网络问题，而是 shell 没加载到 ~/.phpenv/bin 这个路径。
必须确保两件事同时成立：
-
export PATH="$HOME/.phpenv/bin:$PATH"已写入你的 shell 配置文件（~/.bashrc、~/.zshrc或~/.profile） -
eval "$(phpenv init -)"也已写入同一配置文件 —— 这步负责启用 shims 机制，没有它，php命令永远走不了 phpenv 管理的版本 - 改完配置后必须
source ~/.zshrc（或对应文件），不能只开新终端；某些桌面环境（如 GNOME Terminal）甚至需要完全重启终端进程
验证方式：运行 which phpenv 应输出 /home/xxx/.phpenv/bin/phpenv；运行 phpenv init - 应输出一段 shell 函数定义，而不是报错 no such command 'init'（后者说明克隆不完整，建议删掉 ~/.phpenv 重来）。
phpenv install 失败常见原因和应对
phpenv install 8.3.13 卡住、报编译错误或提示 missing dependency，基本是系统缺少构建工具链。phpenv 本身不提供预编译二进制，它调用 php-build 插件从源码编译，所以依赖必须手动装全。
立即学习“PHP免费学习笔记（深入）”；
Ubuntu/Debian 系统需提前运行：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libsqlite3-dev
macOS（Homebrew）需确认：
brew install autoconf automake openssl@3 readline sqlite3 zlib- 注意：PHP 8.2+ 默认要求 OpenSSL 3.x，用
openssl@1.1会编译失败 - 若仍失败，临时加构建参数：
PHP_BUILD_CONFIGURE_OPTS="--with-openssl=$(brew --prefix openssl@3)" phpenv install 8.3.13
另外，phpenv install --list 显示的版本可能滞后于 PHP 官网，新发布的 RC 版本通常要等 php-build 插件更新定义文件后才支持。
卸载 phpenv：删文件 + 清配置，别留残留
卸载不是运行某个 uninstall 命令，而是三步手动清理：
- 删除主目录：
rm -rf ~/.phpenv - 从 shell 配置文件（
~/.bashrc等）中彻底删掉这两行：export PATH="$HOME/.phpenv/bin:$PATH"eval "$(phpenv init -)" - 执行
source ~/.bashrc（或对应文件），再运行which php确认返回的是系统原生路径（如/usr/bin/php），且phpenv命令彻底不可用
容易被忽略的一点：有些用户在项目里用了 phpenv local，会在目录下生成 .php-version 文件。卸载后这些文件不会自动消失，下次进目录如果 phpenv 还在 PATH 里，会触发错误。建议全局搜一遍：find ~ -name ".php-version" -delete 2>/dev/null。
切换版本后 php -v 不变？优先级和 which php 是真相
执行 phpenv global 8.3.13 后 php -v 依然显示旧版本，根本原因只有一个：有别的 PHP 路径比 phpenv 的 shim 更早出现在 $PATH 中。
查清路径顺序：
- 运行
echo $PATH，看/home/xxx/.phpenv/shims是否排在/usr/bin、/opt/homebrew/bin等系统路径之前 - 运行
which php—— 如果输出不是/home/xxx/.phpenv/shims/php，说明 shims 没被优先命中 - 运行
phpenv which php，它会告诉你 phpenv 管理的 PHP 实际路径，比如/home/xxx/.phpenv/versions/8.3.13/bin/php；如果这个路径和which php不一致，就证实了 PATH 冲突
修复方法只有调整 export PATH="$HOME/.phpenv/shims:$PATH"（注意是 shims 子目录，不是 bin），并确保这行在配置文件中位于所有其他 export PATH=... 语句之前。
