phpenv命令找不到的主因是PATH未正确配置，需将$HOME/.phpenv/bin加入PATH并source配置文件；“no such command 'init'”源于克隆时未加--recursive导致子模块缺失；phpenv install依赖php-build插件，须手动安装并rehash；切换版本后php -v不变则因shims路径未优先于系统PHP路径。
phpenv 命令找不到？PATH 没配对是最常见原因
执行 phpenv --version 报 command not found，90% 是因为 $HOME/.phpenv/bin 没进 PATH。不是路径写错，就是 shell 配置文件没 reload。
确认方式：echo $PATH 看输出里有没有 /home/你的用户名/.phpenv/bin（Linux/macOS）或 C:\Users\你的用户名\.phpenv\bin（Windows WSL）。没有就说明漏了这步。
- 用
~/.bashrc还是~/.bash_profile？取决于你用的 shell：Bash 默认读~/.bashrc（终端新窗口），Zsh 读~/.zshrc；macOS Catalina 及之后默认 Zsh，别硬塞到.bash_profile里 - 写完配置后必须
source ~/.zshrc（或对应文件），exec $SHELL -l是备用方案，但不如source直接可靠 - 如果用 VS Code 终端，改完配置要完全关闭再重开，它不自动 reload shell 配置
phpenv init - 报 “no such command 'init'” 怎么办
这个错误只有一种可能：克隆仓库不完整，git clone 卡了或中断过。官方仓库依赖子模块（比如 php-build 插件），单纯 git clone 不加 --recursive 会漏掉关键目录。
正确做法是删掉旧目录重来：
立即学习“PHP免费学习笔记（深入）”；
rm -rf ~/.phpenv-
git clone --recursive https://gitcode.com/gh_mirrors/ph/phpenv.git ~/.phpenv（注意带--recursive） - 再执行
echo 'eval "$(phpenv init -)"' >> ~/.zshrc，然后source ~/.zshrc
别图省事用 phpenv-installer 脚本——它在 2026 年已多年未维护，容易拉取过期镜像或权限异常。
装完 phpenv install 却提示找不到该命令
phpenv install 不是 phpenv 自带功能，它来自 php-build 插件。没装插件，phpenv install 就是无效命令，连 tab 补全都不会出现。
手动安装插件是唯一稳妥方式：
- 确认
phpenv root输出路径（通常是~/.phpenv） git clone https://gitcode.com/gh_mirrors/ph/php-build $(phpenv root)/plugins/php-build- 装完立刻运行
phpenv rehash，否则新命令不生效 - 验证：
phpenv commands应该能看到install和uninstall
注意：Ubuntu/Debian 用户必须先装编译依赖，否则 phpenv install 8.3.13 会在 configure 阶段失败，报一堆 libxml2 not found 类错误。运行一次 sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev 再试。
切换版本后 php -v 不变？检查 shim 是否被绕过
phpenv 本质是靠 shim（小包装脚本）劫持 php 命令调用。如果 which php 返回的是 /usr/bin/php 或 /opt/homebrew/bin/php，说明系统自带 PHP 或 Homebrew PHP 的路径优先级更高，shim 没生效。
- 执行
phpenv rehash强制重建所有 shim 文件（每次装新版本后都该做） - 检查
echo $PATH中~/.phpenv/shims是否排在系统 PHP 路径前面；如果不是，调整 shell 配置里export PATH的顺序 - 临时验证：直接运行
~/.phpenv/shims/php -v，如果这里显示的是目标版本，说明只是 PATH 顺序问题 - 项目级切换用
phpenv local 8.1.10，它会在当前目录生成.phpenv-version文件，比global更精准，也更不容易被全局环境干扰
最易忽略的一点：某些 IDE（如 PhpStorm）会缓存 PHP 解释器路径，改完 phpenv 后要在 Settings → PHP → Interpreter 里手动重新选一次，不能只信终端输出。
