phpenv install 7.4.33 失败主因是缺php-build插件、编译依赖未装或PATH未生效；需先克隆插件、安装libxml2-dev等开发库、执行phpenv rehash，并用phpenv which php验证路径是否指向新版本。
phpenv install 7.4.33 是添加 PHP 7.4 的标准命令，但直接运行大概率失败——缺编译依赖、没装插件、PATH 没生效，三者占 90% 以上的安装卡点。
phpenv install 7.4.33 报错“command not found”或“No known version”
这是最常遇到的第一道墙。原因不是命令写错，而是 phpenv 本身没识别到 install 子命令，本质是缺少 php-build 插件。
- phpenv 默认只管切换，不带编译能力；
install功能由php-build插件提供 - 必须手动克隆插件到指定路径：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 插件装完后，执行
phpenv rehash让 shims 生效 - 再运行
phpenv install --list | grep 7.4就能看到可用的 7.4.x 版本了
phpenv install 7.4.33 编译失败：configure: error 或 missing library
PHP 7.4 编译对系统依赖比新版更敏感，尤其在 macOS 或较新 Linux 发行版上，常见报错如 configure: error: xml2-config not found 或 openssl/ssl.h: No such file or directory。
- Ubuntu/Debian：装
libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev zlib1g-dev - macOS（Homebrew）：装
libxml2 openssl@3 curl jpeg pngquant freetype，并导出路径：export PATH="/opt/homebrew/opt/libxml2/bin:$PATH" - 关键环境变量别漏：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl --with-curl"（根据报错补） - 如果仍失败，加
-v参数看完整日志：phpenv install -v 7.4.33
装好了却切不到 7.4.33：php -v 还是旧版本
装成功 ≠ 用得上。phpenv 的版本生效依赖 shims 机制和目录上下文，常见断点有三个：
立即学习“PHP免费学习笔记（深入）”；
- 没执行
phpenv rehash：每次新装版本后都必须运行，否则~/.phpenv/shims/php不会指向新二进制 -
phpenv local 7.4.33只在当前目录生效，且会生成.php-version文件——确认你cd到了目标项目根目录再执行 - 终端已打开太久，shell 缓存了旧的
which php结果；简单粗暴办法：hash -d php清缓存，或新开一个终端 - 验证是否真生效：
phpenv which php应输出类似/home/xxx/.phpenv/versions/7.4.33/bin/php
真正麻烦的不是装，是装完发现 composer 用的还是旧 PHP——因为 Composer 会缓存 php 路径。只要改过全局或 local 版本，顺手跑一次 composer self-update 和 composer clear-cache，不然 autoload 或扩展加载可能静默出错。
