phpenv 命令大小写敏感且依赖正确配置：path需包含~/.phpenv/bin，shell配置文件要匹配（zsh用~/.zshrc），php-build插件须置于指定路径，编译依赖须预装，shim机制易被alias或错误.php-version干扰，非交互式环境需显式init。
phpenv 不是 phpEnv，大小写敏感，命令行中必须小写 —— 这是第一步就容易卡住的地方。如果你执行 phpEnv --version 报错“command not found”，大概率是拼错了。
phpenv 安装失败的常见原因：PATH 和 shell 配置没生效
-
phpenv二进制文件在~/.phpenv/bin，但很多用户只改了~/.bash_profile，却用的是zsh（macOS Catalina 及之后默认），导致PATH没加载 -
echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.profile对 zsh 用户无效，应写入~/.zshrc - 执行
exec $SHELL -l后仍不识别命令？检查~/.phpenv/bin是否真在$PATH中：echo $PATH | grep phpenv - 克隆仓库时漏掉
.git后缀（部分镜像地址已更新），推荐用完整地址：git clone @#@#@#@#@#@#@#@#@#@0 ~/.phpenv
phpenv install 命令无法使用：缺 php-build 插件
phpenv install 不是内置命令，它依赖插件 php-build：
- 插件必须放在
$(phpenv root)/plugins/php-build下，路径不能错 - 正确安装方式：
git clone @#@#@#@#@#@#@#@#@#@1 $(phpenv root)/plugins/php-build - 安装前确保系统有编译依赖（Ubuntu/Debian）：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS 用户需先装
libxml2和openssl：brew install libxml2 openssl，再通过环境变量告知编译器：export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/opt/homebrew/opt/openssl"（Apple Silicon 路径可能不同）
切换版本后 php -v 不变：shim 机制被绕过
phpenv 靠 shim 拦截 php、composer 等命令，但以下情况会失效：
- 终端里手动加了
alias php='/usr/bin/php'，优先级高于 shim -
which php返回的是系统路径（如/usr/bin/php）而非~/.phpenv/shims/php，说明phpenv init -没成功注入或未重载 - 项目目录下有
.php-version，但内容带空格或换行符（比如"8.3.13 "），会导致解析失败 —— 用cat -A .php-version检查 -
phpenv rehash必须在每次新装 PHP 版本后运行，否则 shim 文件不会生成对应二进制链接
真正麻烦的不是装不上，而是装上后行为不一致：比如 CI 流水线里 phpenv global 8.3.13 生效，但 php -v 仍是系统默认版本。这种问题往往出在非交互式 shell（如 GitHub Actions 的 runner）不加载 ~/.zshrc，只能靠显式初始化：eval "$(~/.phpenv/bin/phpenv init -)"。别跳过这一步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
