需安装基础编译环境：Ubuntu/Debian执行sudo apt install -y build-essential libxml2-dev等，CentOS/RHEL执行sudo yum groupinstall "Development Tools"并补装devel包。
phpenv install 报错 “no acceptable C compiler found” 怎么办
这是最典型的前置依赖缺失信号，不是 PHP 本身的问题，而是系统连基础编译环境都没装全。报错里出现 configure: no acceptable c compiler found in $PATH 或 checking for xml2-config... not found，说明 build-essential、libxml2-dev 这类包根本没装。
Ubuntu/Debian 系统直接运行：
sudo apt-get update sudo apt-get install -y build-essential autoconf bison re2c libxml2-dev libssl-dev libcurl4-openssl-dev libreadline-dev libsqlite3-dev libbz2-dev libjpeg-dev libpng-dev libfreetype6-dev zlib1g-dev
CentOS/RHEL（8+）用 dnf：
sudo dnf groupinstall "Development Tools" sudo dnf install -y autoconf bison re2c libxml2-devel openssl-devel curl-devel readline-devel sqlite-devel bzip2-devel libjpeg-devel libpng-devel freetype-devel zlib-devel
- 别只装
libxml2，必须装libxml2-dev（Debian）或libxml2-devel（RHEL），头文件才是编译时真正需要的 -
build-essential（Debian）或"Development Tools"（RHEL）是基础，漏掉会导致连gcc都找不到 - 如果后续还报
libzip not found或oniguruma not found，补上libzip-dev和libonig-dev
phpenv 命令找不到或 init 失败
克隆完 phpenv 后输 phpenv 提示 command not found，大概率是 PATH 没生效，或者 init 脚本压根没加载成功。
立即学习“PHP免费学习笔记（深入）”；
确认安装路径是 ~/.phpenv（不是 ~/phpenv），然后检查 shell 配置文件（~/.bashrc 或 ~/.zshrc）是否包含这两行：
export PATH="$HOME/.phpenv/bin:$PATH" eval "$(phpenv init -)"
改完后必须执行：
source ~/.bashrc # 或 source ~/.zshrc
- 如果
phpenv init -报no such command 'init'，说明仓库没完整 clone，删掉~/.phpenv重来，确保用的是官方地址https://github.com/phpenv/phpenv - Mac 用户注意：M系列芯片若用 Rosetta 终端，可能 PATH 解析异常，建议统一用原生 Terminal + zsh
-
phpenv init -输出为空？先确认~/.phpenv/plugins/php-build存在，这个插件是install功能的底层依赖
编译卡在 [Compiling] 半小时不动
这不是网络问题，是内存爆了。尤其在 1GB 内存的 VPS（比如 AWS t2.micro）上，make -j$(nproc) 默认开满 CPU 核数并发编译，瞬间吃光 swap，进程挂起无响应。
临时解决方法（不用加 swap）：
export MAKEFLAGS="-j1" phpenv install 7.4.30
-
-j1强制单线程编译，速度慢但稳，适合小内存机器 - 如果仍失败，检查
/tmp是否空间不足（df -h /tmp），PHP 编译默认用/tmp当工作目录 - 不要手动删
/tmp/php-build/source/下的残留目录再重试——先phpenv uninstall 7.4.30清干净，否则容易触发缓存校验失败
装完 phpenv global 切不了版本
输入 phpenv global 7.4.30 没报错，但 php -v 还是旧版本，问题几乎全出在 shim 机制没更新。
必须立刻执行：
phpenv rehash
然后再验证：
phpenv versions phpenv global 7.4.30 php -v
-
rehash不是可选项，是必须步骤——它会在~/.phpenv/shims/下生成对应版本的php、composer等符号链接 - 如果
phpenv versions里看不到刚装的版本，说明安装实际失败了，去翻日志：tail -50 ~/.phpenv/plugins/php-build/share/php-build/log/7.4.30.log - zsh 用户遇到
command not found: phpenv却已配置好 PATH？可能是 oh-my-zsh 的某些插件冲突，临时关掉插件测试
编译依赖和 shim 更新这两步最容易被跳过，但恰恰是 90% 安装失败的根源。别急着重装系统，先盯住 log 文件末尾三行和 phpenv rehash 是否真执行了。
