phpenv无真正一键安装，需手动配置PATH与init；command not found主因是shell类型（bash/zsh）错配、配置文件路径错误或权限问题，须确保~/.phpenv/bin加入正确shell配置且顺序靠前。
phpenv 没有一键安装包，所谓“一键”实际是几条 shell 命令组合，但容易卡在 PATH 配置或 init 初始化失败上——根本原因不是命令不对，而是 shell 类型、配置文件路径、权限三者没对齐。
为什么 phpenv install 总提示 command not found
这不是安装失败，是 phpenv 命令压根没进 PATH 或没加载初始化逻辑。
-
which phpenv返回空？说明~/.phpenv/bin没加进 PATH，检查你改的是~/.bashrc还是~/.zshrc—— macOS Catalina 后默认 zsh，Linux 多数用 bash，别混了 -
echo $PATH里没有~/.phpenv/bin？确认 echo 命令写进了正确的配置文件，且用了>> ~/.zshrc而不是> ~/.zshrc（后者会清空原有内容） -
phpenv init -报错 “no such command ‘init’”？说明克隆不完整，删掉~/.phpenv重来，用git clone https://github.com/phpenv/phpenv.git ~/.phpenv（别用镜像站，部分镜像缺失 hooks 子模块）
phpenv install 编译失败的常见硬伤
报错集中在 configure: error: no acceptable C compiler found in $PATH 或 fatal error: 'openssl/ssl.h' file not found，本质是系统缺编译依赖，不是 phpenv 问题。
- Ubuntu/Debian：必须先跑
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS：装 Xcode Command Line Tools：
xcode-select --install，再装 OpenSSL：brew install openssl，然后加参数指定路径：phpenv install 8.3.13 --with-openssl=$(brew --prefix openssl) - CentOS/RHEL：
sudo yum groupinstall "Development Tools"+sudo yum install openssl-devel bzip2-devel curl-devel libjpeg-devel libpng-devel readline-devel sqlite-devel zlib-devel
php -v 不变？优先检查 which php 的输出
切换版本后 php -v 还是旧版本，大概率是其他 PHP 路径抢在 phpenv 前面了。
立即学习“PHP免费学习笔记（深入）”；
- 执行
which php，如果返回/usr/bin/php或/opt/homebrew/bin/php，说明系统自带或 Homebrew 安装的 PHP 优先级更高 - 执行
phpenv rehash强制刷新 shim 符号链接（每次phpenv install后都要做） - 确认
~/.phpenv/shims在 PATH 中且位置靠前，比如你的~/.zshrc应该是：export PATH="$HOME/.phpenv/shims:$HOME/.phpenv/bin:$PATH"，顺序不能反
项目级版本不生效？.php-version 文件要手动生成
phpenv local 8.3.13 只是往当前目录写一个 .php-version 文件，它本身不触发切换；真正起作用的是 phpenv 的 shim 机制在每次调用 php 时读这个文件。
- 确认文件存在：
cat .php-version应输出8.3.13（纯文本，无空格、无换行） - 不要用 Windows 编辑器保存，避免 CRLF 换行符导致解析失败；推荐用
echo "8.3.13" > .php-version - 子目录不会继承父目录的
.php-version，每个需要独立版本的项目根目录都得有它 - 如果用了 IDE（如 PhpStorm），它可能缓存了 PHP 解释器路径，需手动在设置里指向
~/.phpenv/shims/php
最常被忽略的点：phpenv 的 shims 是通过 PATH 注入实现的，任何直接调用绝对路径（比如 /usr/bin/php）或 IDE 硬编码路径的行为，都会绕过版本控制。别只盯着命令行，检查所有调用 PHP 的入口。
