phpenv命令找不到是因为PATH未包含~/.phpenv/bin；需检查echo $PATH输出，若缺失则编辑~/.bashrc添加export PATH="$HOME/.phpenv/bin:$PATH"并source生效。
phpenv 命令找不到：PATH 没配对
执行 phpenv 报 command not found，不是没装好，而是 shell 根本没看见它。关键看 ~/.phpenv/bin 在不在 $PATH 里。
检查方法：echo $PATH，确认输出中包含 /home/用户名/.phpenv/bin（Linux/macOS）或 C:\Users\用户名\.phpenv\bin（Windows Git Bash 下）。没看到就说明漏了这步。
- 编辑
~/.bashrc（或~/.zshrc）追加：export PATH="$HOME/.phpenv/bin:$PATH" - 运行
source ~/.bashrc（或对应配置文件）立即生效 - Windows 用户若用 Git Bash，注意路径分隔符是
/，且不能用%USERPROFILE%变量，得写死成/c/Users/xxx/.phpenv/bin
phpenv install 卡住或编译失败
常见于 Ubuntu/Debian 系统，phpenv install 8.1.10 卡在 [Compiling] 或直接报错退出，90% 是缺系统级依赖，不是 PHP 本身的问题。
Ubuntu/Debian 必装依赖：sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libxml2-dev libsqlite3-dev
立即学习“PHP免费学习笔记（深入）”；
- 别只装
build-essential就以为够了——libxml2-dev缺失会导致 configure 阶段失败，但错误日志藏得深 - 编译失败后，立刻查日志：
tail -n 50 ~/.phpenv/plugins/php-build/share/php-build/log/8.1.10.log，重点看最后一行是不是configure: error:开头 - macOS 用户用 Homebrew，需先
brew install openssl@1.1 readline sqlite3 xz，再设环境变量：export PATH="/opt/homebrew/opt/openssl@1.1/bin:$PATH"
切换版本后 php -v 不变
执行 phpenv global 8.1.10 后，php -v 还显示旧版本，说明 phpenv 的 shim 机制没接管成功。
核心原因有两个：一是 which php 返回的路径不是 ~/.phpenv/shims/php；二是刚装完没运行 phpenv rehash。
- 先跑
which php，如果输出是/usr/bin/php或/usr/local/bin/php，说明系统自带 PHP 或其他管理工具（如 XAMPP、brew install php）抢在前面 - 确认
~/.phpenv/shims已加入$PATH，且位置比系统路径靠前（export PATH="$HOME/.phpenv/shims:$PATH"） - 每次新装 PHP 版本后必须手动运行
phpenv rehash，否则 shims 目录里不会生成对应可执行文件
Web 服务器用的不是 phpenv 切换的版本
php -v 是 8.1，但浏览器访问 phpinfo() 显示 7.4，说明 Apache/Nginx 调用的是另一个 PHP 解释器，和 CLI 完全无关。
CLI 和 Web SAPI 是两套独立路径。phpenv 只管命令行，不改 Web 服务器配置。
- Apache 用户检查
LoadModule php_module指向的libphp.so文件路径，是否来自你期望的 PHP 版本安装目录 - Nginx + PHP-FPM 用户，检查
fastcgi_pass对应的 socket 或端口，再查该 PHP-FPM 进程启动时加载的php-fpm.conf和php.ini路径 - 最简单验证法：在
phpinfo()页面搜索 “Loaded Configuration File”，看实际加载的是哪个php.ini，再反推它属于哪个 PHP 安装
