phpenv命令找不到的主因是PATH未包含~/.phpenv/bin或shell配置未生效；需确认安装路径、将该路径加入对应shell配置文件（如~/.zshrc）、source重载，并运行phpenv rehash重建shims。
phpenv 命令找不到？不是没装好，大概率是 PATH 或初始化没生效。
phpenv 命令提示 "command not found"
这是最常遇到的第一道坎。根本原因不是安装失败，而是 shell 找不到 phpenv 可执行文件。
- 先确认安装路径是否正确：
ls ~/.phpenv/bin/phpenv应该存在且有可执行权限 - 检查
$PATH是否包含~/.phpenv/bin：echo $PATH | grep phpenv，若无输出，说明没加进去 - 别只改
~/.bashrc就完事——如果你用的是 zsh（macOS Catalina+ 默认），得改~/.zshrc；Ubuntu 新版本也默认用 bash，但部分桌面环境可能加载~/.profile - 加完配置后必须重载：用
source ~/.zshrc（或对应文件），而不是仅靠新开终端——有些终端不会自动读取 login shell 配置
phpenv install 报错：configure: error: no acceptable C compiler found
这不是 phpenv 的问题，是系统缺编译工具链。php-build 插件需要完整 GCC 环境才能编译 PHP 源码。
- Ubuntu/Debian：
sudo apt-get install -y build-essential autoconf bison libxml2-dev libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - macOS（Homebrew）：
brew install autoconf automake openssl libxml2，再确保 Xcode Command Line Tools 已安装：xcode-select --install - 报错里出现
libzip、oniguruma相关缺失时，不要跳过——它们是 PHP 8.0+ 的硬依赖，漏掉会导致后续扩展加载失败 - 安装中途失败，日志在
~/.phpenv/plugins/php-build/share/php-build/log/8.3.13.log（以实际版本号为准），直接tail -n 50查最后几十行比盲试更省时间
切换版本后 php -v 仍显示旧版本
说明 phpenv 的 shim 机制没接管住 php 命令，系统优先调用了其他路径的 PHP。
立即学习“PHP免费学习笔记（深入）”；
- 查真实调用路径：
which php—— 如果返回/usr/bin/php或/opt/homebrew/bin/php，就证明 phpenv 没生效 - 运行
phpenv rehash强制重建所有 shim 文件（~/.phpenv/shims/php等），这是解决“版本已装但不生效”的最快操作 - 检查是否有其他版本管理工具干扰：比如 MAMP、XAMPP、Homebrew 自带的 php，它们的 bin 目录如果在
$PATH中排在~/.phpenv/shims前面，就会抢跑 - 验证 shim 是否起作用：
phpenv which php应该输出类似~/.phpenv/versions/8.3.13/bin/php，否则就是 shims 层没挂上
项目级版本不自动生效：.php-version 文件被忽略
phpenv 支持目录级版本控制，但触发条件很具体，容易被忽略。
-
.php-version文件必须放在项目根目录，且内容只能是纯版本号，例如8.3.13，不能带空格、注释或额外字符 - 确保当前 shell 是登录 shell（login shell），否则
eval "$(phpenv init -)"中的 hook 不会加载——Zsh 用户注意：默认非 login shell 不加载~/.zshrc，需在终端设置里勾选 “Run command as a login shell” - 执行
phpenv version看输出：如果是system，说明没检测到本地设置；如果是8.3.13 (set by /path/to/project/.php-version)，才表示成功识别 - 不建议混用
phpenv local和手动写.php-version—— 后者是前者生成的，重复操作可能导致冲突
真正卡住人的往往不是命令记不住，而是 shim 层和 PATH 加载顺序这种底层链路没理清。多看 which php 和 phpenv which php 的差异，比反复重装快得多。
