phpenv command not found 的核心原因是 PATH 未正确配置或加载顺序错误，需确认 ~/.phpenv/bin 是否在 $PATH 中、配置文件（如 ~/.zshrc）是否写入 export PATH="$HOME/.phpenv/bin:$PATH" 且位于其他 PATH 修改之前，并用 source 重载；Mac 使用 zsh 时勿将配置写入 .bash_profile。
phpenv command not found：PATH 没生效或加载顺序错
终端输入 phpenv 提示“command not found”，不是没装好，而是 shell 找不到它。核心问题在 PATH 未正确插入或被其他路径覆盖。
- 检查
~/.phpenv/bin是否真在 PATH 中：运行echo $PATH | tr ':' '\n' | grep phpenv - 确认 shell 配置文件（
~/.zshrc或~/.bash_profile）里写了这行：export PATH="$HOME/.phpenv/bin:$PATH"，且写在其他 PATH 修改之前 - 重载配置后必须用
source ~/.zshrc（别只改完就关终端） - Mac 上若用 zsh 但配置写在
.bash_profile，它根本不会被读取——zsh 默认不加载 bash 的配置
phpenv install 失败：php-build 插件缺失或版本不匹配
phpenv install 报错 “command not found: php-build” 或编译中断，90% 是因为没装 php-build 插件，或已装但和当前 phpenv 版本不兼容。
- 手动安装插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - Linux/macOS 编译 PHP 前必须装齐系统依赖：Ubuntu/Debian 运行
sudo apt install autoconf bison build-essential libssl-dev libxml2-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev libicu-dev libmcrypt-dev libreadline-dev - macOS 用户注意：M1/M2 芯片需用
arch -arm64 brew install安装依赖，否则编译会卡在 configure 阶段 - PHP 8.3+ 在某些旧版 php-build 下无法安装，建议更新插件：
cd $(phpenv root)/plugins/php-build && git pull
phpenv version 显示 system，但实际想用刚装的版本
运行 phpenv version 返回 system，说明 phpenv 没接管 PHP 解释器——它只是个版本路由工具，不自带 PHP 二进制。
- 先确认是否真装了目标版本：
phpenv install --list | grep 8.2，再执行phpenv install 8.2.15 - 装完必须显式设置：
phpenv global 8.2.15（全局）或phpenv local 8.2.15（当前目录） - 如果仍显示 system，运行
which php看指向哪；若返回/usr/bin/php，说明 phpenv 的 shims 没生效，检查~/.phpenv/shims是否在 PATH 最前面 - Windows 不适用 phpenv（它是 Unix 工具），别在 WSL 以外环境折腾
php -v 正常但 phpinfo() 不生效：Web 服务器没连上 PHP-FPM
命令行能跑 php -v，但浏览器访问 info.php 只显示源码或 502，问题不在 phpenv，而在 Web 服务与 PHP 的对接环节。
立即学习“PHP免费学习笔记（深入）”；
- phenv 管 CLI 版本，PHP-FPM 是另一套进程——必须单独启动：
phpenv which php-fpm找到二进制，再$(phpenv which php-fpm) -D后台运行 - Nginx 配置里
fastcgi_pass必须指向正确的 socket 或端口，例如127.0.0.1:9000，而该端口得由当前 phpenv 版本的 php-fpm 监听 - Apache 用户注意：
LoadModule php_module是旧方式，PHP 7.4+ 推荐用proxy_fcgi+SetHandler "proxy:fcgi://127.0.0.1:9000" - 每次换 phpenv 版本后，务必重启 php-fpm 和 Web 服务，否则还是用的老进程
php 命令路由过去，而 Web 请求走的是 PHP-FPM 进程，两者默认不联动——这个边界，文档很少明说，但踩一次就忘不掉。 
