phpenv启动失败主因是环境变量未生效或编译依赖缺失；需检查PATH配置、执行phpenv init、安装系统构建工具，并运行phpenv rehash刷新shims。
phpenv 启动失败，90% 是环境变量没生效或编译依赖缺失，不是工具本身坏了。
phpenv 命令找不到：PATH 和 init 没配对
装完 phpenv 却输 phpenv 报 command not found，说明 shell 根本没加载它。
- 确认安装路径是
~/.phpenv（不是~/phpenv或其他路径），用ls -la ~/.phpenv/bin看有没有可执行文件 - 检查
~/.bashrc（或~/.zshrc）里是否同时写了三行：export PATH="$HOME/.phpenv/bin:$PATH"export PATH="$HOME/.phpenv/shims:$PATH"eval "$(phpenv init -)" -
eval "$(phpenv init -)"必须在 PATH 设置之后，否则 shims 目录进不了搜索路径 - 改完后别只
source ~/.bashrc，新开一个终端再试——有些 shell 不会重载 shims 的符号链接缓存
phpenv install 编译中断：缺的是系统级依赖，不是 PHP 扩展
phpenv install 8.1.27 卡在 configure: error: no acceptable C compiler found in $PATH 或 checking for xml2-config... not found，这是 Ubuntu/Debian 系统没装基础构建工具和头文件。
- 先跑一遍：
sudo apt-get update && sudo apt-get install -y build-essential autoconf bison re2c libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev - CentOS/RHEL 换成：
sudo yum groupinstall "Development Tools" && sudo yum install -y autoconf bison re2c libxml2-devel openssl-devel curl-devel libjpeg-devel libpng-devel freetype-devel - macOS 用户注意：
libxml2要用brew install libxml2，但默认不 link 到 /usr/include；得加--with-libxml-dir=/opt/homebrew/opt/libxml2（Apple Silicon）或--with-libxml-dir=/usr/local/opt/libxml2（Intel） - 错误日志藏在：
~/.phpenv/plugins/php-build/share/php-build/log/8.1.27.log，别只看终端最后一屏
php --version 还是旧版本：shims 没刷新或 global 设置失效
明明 phpenv install 8.2.12 成功了，phpenv versions 也列出它，但 php --version 仍是 7.4 ——说明 php 命令没走 phpenv 的 shim。
立即学习“PHP免费学习笔记（深入）”；
- 先执行
phpenv rehash，强制重建所有版本的 shim 可执行文件 - 再确认当前作用域：
phpenv version显示 local/global 哪个在生效；phpenv global 8.2.12才真正切换全局默认 - 如果用了
phpenv local 8.1.27，检查当前目录下有没有.php-version文件，且内容是不是纯数字版本号（不能带空格或注释） - 运行
which php，输出必须是~/.phpenv/shims/php；如果是/usr/bin/php或/opt/homebrew/bin/php，说明 PATH 顺序错了或者phpenv init没执行成功
PHP 启动后立即退出：别只盯 phpenv，先查端口和配置冲突
用 php -S localhost:8000 启服务，一闪就退，没报错也没日志——大概率是端口被占，或 php.ini 里开了不兼容的扩展。
- 查端口：
lsof -i :8000（macOS/Linux）或netstat -ano | findstr :8000（Windows），杀掉 PID 对应进程 - 验证配置语法：
php -c /path/to/php.ini -l /dev/null（空文件测试 ini 是否能加载），或直接php --ini看实际加载路径 - 临时禁用扩展：把
php.ini里extension=开头的行全注释掉，再试启动；常见雷区是opcache（某些旧版与 PHP 8.2+ 不兼容）、pdo_mysql（依赖库路径不对） - 特别注意：phpenv 安装的 PHP 默认不带 Apache 模块，
libphp.so错误跟 phpenv 无关，那是你手动配 Apache 时路径写错了
最常被跳过的动作是 phpenv rehash 和检查 which php 输出路径——这两步花 10 秒，却能避开 70% 的“启动失败”假象。
