phpenv命令找不到的首要原因是PATH未生效，需确认安装路径、在shell配置文件中添加export PATH="$HOME/phpenv/bin:$PATH"并执行source重载；装完PHP版本后需运行phpenv rehash重建shims才能切换成功。
phpenv 命令找不到：PATH 没生效是最常见原因
安装完 phpenv 后输 phpenv 报 “command not found”，基本就是 shell 没加载到它的 bin 目录。不是安装失败，是路径没通。
- 先确认安装位置：
ls ~/phpenv/bin/看是否存在phpenv可执行文件 - 检查
~/.bash_profile或~/.zshrc（macOS Catalina 以后默认 zsh）是否加了这行：export PATH="$HOME/phpenv/bin:$PATH" - 改完别忘了重载：
source ~/.zshrc（或source ~/.bash_profile），再新开一个终端测试 - 如果用的是 Oh My Zsh，某些主题会覆盖
PATH，建议把export行放在配置文件最末尾
装完 PHP 版本却切不动：shim 没重建
phpenv install 8.2.12 成功了，但 phpenv global 8.2.12 没反应，php -v 还是旧版本——这是因为 phpenv 依赖 shim 脚本来代理调用，新版本装完不会自动注册。
- 必须手动运行：
phpenv rehash，它会扫描~/.phpenv/versions/下所有已安装版本，生成对应 shim - 验证是否成功：
ls ~/.phpenv/shims/应该能看到php、composer、pecl等链接文件 - 如果
rehash报错“Permission denied”，说明~/.phpenv/shims目录权限异常，用chmod 755 ~/.phpenv/shims修复
phpenv install 编译失败：缺系统级依赖或头文件
错误日志里出现 configure: error: xml2-config not found 或 fatal error: openssl/ssl.h: No such file or directory，本质是编译器找不到开发头文件，不是 PHP 本身的问题。
- Ubuntu/Debian：
sudo apt-get install libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev autoconf bison re2c pkg-config build-essential - macOS（Homebrew）：
brew install libxml2 openssl@3 curl jpeg pngquant freetype autoconf automake bison re2c pkg-config，并确保pkg-config能找到它们（必要时加export PKG_CONFIG_PATH="/opt/homebrew/opt/openssl@3/lib/pkgconfig"） - 编译卡在
make阶段且内存溢出？加MAKEFLAGS="-j2"限制并发数，避免 Mac 小内存机器崩溃
切换 PHP 版本后 MySQL 服务异常：端口或 socket 冲突
用 phpenv global 8.3.0 后发现本地 MySQL 启动失败，日志报 Can't start server: Bind on TCP/IP port: Address already in use 或 mysql.sock not found，大概率是 PHP 切换触发了环境变量变更，间接影响了 MySQL 启动脚本。
立即学习“PHP免费学习笔记（深入）”；
- 检查是否误设了
MYSQL_UNIX_PORT或PHP_INI_SCAN_DIR，这些变量可能被phpenv的 hook 脚本注入，干扰 MySQL 服务初始化 - 临时绕过：
sudo systemctl stop mysql→ 清空/tmp/mysql.sock→ 手动指定 socket 启动：sudo mysqld --socket=/var/run/mysqld/mysqld.sock - 根本解法：MySQL 服务应脱离用户级 PHP 环境管理，用系统服务方式运行（
systemctl enable mysql），不要依赖phpenv的shell或local上下文
phpenv shell 绑定，出问题时排查路径会绕很大一圈。 
