phpenv install 命令报“command not found”是因为该命令依赖 php-build 插件，需手动克隆安装；编译失败主因是系统缺少 autoconf、build-essential 等构建依赖或 OpenSSL/zlib 路径配置不一致。
直接装 phpenv 本身不带任何 PHP 版本，必须配合 php-build 插件才能编译安装具体版本——这是最常卡住的起点。
phpenv install 命令为什么报错“command not found”
因为 phpenv install 不是 phpenv 自带命令，它来自插件 php-build。没装这个插件，phpenv install 就根本不存在。
- 先确认插件是否已安装：
ls $(phpenv root)/plugins/php-build应该有文件输出 - 没装就运行：
git clone https://gitcode.com/gh_mirrors/ph/php-build $(phpenv root)/plugins/php-build - 插件装完后，
phpenv install --list才能列出可安装的版本（如8.3.13、7.4.33） - Zsh 用户注意：
phpenv init -输出可能含 Zsh 专用语法，若报错可改用phpenv init - zsh
安装 PHP 时编译失败的典型原因
错误通常表现为 configure: error: xxx not found 或 make: *** No rule to make target 'install'，本质是系统缺少构建依赖或路径配置不对。
- Ubuntu/Debian 必装依赖：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS（Homebrew）：
brew install autoconf automake openssl@3 readline zlib，并确保PATH包含brew --prefix/bin - 若需 OpenSSL 支持，设置：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/usr"（路径按实际调整） - PHP 8+ 默认不装 PEAR，加
--with-pear才能用pecl，否则后续装xdebug会失败
切换版本后 php -v 仍显示旧版本
不是 phpenv 没生效，而是 shell 找到了其他路径下的 php，优先级盖过了 phpenv 的 shim。
立即学习“PHP免费学习笔记（深入）”；
- 查当前执行路径：
which php—— 正常应返回~/.phpenv/shims/php - 如果不是，检查
$PATH：echo $PATH，确认~/.phpenv/shims在系统 PHP 路径（如/usr/bin）之前 - 手动补救：
phpenv rehash强制重建所有 shim 文件 - 项目级切换失效？确认项目根目录下有
.php-version文件，内容只能是纯版本号，如8.3.13，不能带空格或注释
真正麻烦的点不在安装步骤，而在于不同系统对 OpenSSL、zlib 等依赖的路径和命名不一致，同一个 configure 参数在 Ubuntu 和 macOS 上可能指向完全不同的位置。
