phpenv命令不可用或PHP版本未切换，主因是shell配置未生效、PATH缺失或shim机制断链；需确认配置文件位置并重载，检查phpenv安装完整性，确保shims路径加入PATH，且执行phpenv rehash生成软链接。
phpenv 配置后 phpenv 命令仍不可用，或 php --version 未切换到预期版本，本质是 shell 初始化没生效、PATH 或 shim 机制断链 —— 不是重装就能解决的问题。
shell 配置文件写错位置或未重载
常见现象：执行 phpenv --version 提示 command not found；echo $PATH 里看不到 $HOME/.phpenv/bin。
- 确认你编辑的是当前 shell 正在读的配置文件：
bash用户看~/.bashrc或~/.bash_profile，zsh用户必须改~/.zshrc（macOS Catalina 及以后默认 zsh） -
export PATH="$HOME/.phpenv/bin:$PATH"和eval "$(phpenv init -)"必须都在同一配置文件中，且不能被注释掉 - 改完后别只关终端再开——执行
source ~/.zshrc（或对应文件）立即重载；exec $SHELL -l也能强制加载登录环境 - 验证是否生效：
which phpenv应输出/home/xxx/.phpenv/bin/phpenv（Linux）或/Users/xxx/.phpenv/bin/phpenv（macOS）
phpenv init 输出为空或报错 “no such command 'init'”
说明 phpenv 本体不完整，或安装路径有误 —— 多见于手动克隆时漏了子模块，或用了错误的镜像源。
- 检查
~/.phpenv/bin/下是否存在phpenv可执行文件；不存在就说明克隆失败，删掉重来：rm -rf ~/.phpenv && git clone https://gitcode.com/gh_mirrors/ph/phpenv.git ~/.phpenv -
phpenv init -是由libexec/phpenv-init提供的，若提示 “no such command”，大概率是仓库没克隆全（比如跳过了libexec/目录），不要自己补文件，重新克隆 - 某些旧版 shell（如 macOS 自带的
zsh早期版本）对$(...)嵌套支持弱，可临时拆成两步：phpenv_init_out=$(phpenv init -); eval "$phpenv_init_out"
全局版本设置后 php --version 仍是系统自带 PHP
根本原因：shim 机制未触发，php 命令还没被 phpenv 接管，系统仍在调用 /usr/bin/php。
立即学习“PHP免费学习笔记（深入）”；
- 先确认已安装目标版本：
phpenv install 8.3.13（若没装，phpenv global只是存个标记，不生效） - 安装完务必运行
phpenv rehash—— 它会扫描~/.phpenv/versions/下所有已安装版本，在~/.phpenv/shims/生成对应php、composer等软链接 - 检查
which php是否指向~/.phpenv/shims/php；如果不是，说明~/.phpenv/shims没加进 PATH，需在配置文件中把这行也加上：export PATH="$HOME/.phpenv/shims:$PATH" -
phpenv global 8.3.13后，运行phpenv version看输出是否为8.3.13 (set by /home/xxx/.phpenv/version)；若显示system，说明全局设置未落盘
项目内 local 版本不生效，但 global 正常
这是路径感知问题：phpenv 只在当前目录或父级目录找到 .php-version 文件时才触发 local 切换。
-
phpenv local 7.4.33会在当前目录生成.php-version文件，内容就是7.4.33；手动创建也行，但注意无空格、无换行 - cd 进子目录后失效？因为子目录下没有
.php-version，phpenv 不会向上递归查找 —— 除非你在顶层目录设了 local，否则每个子项目要单独设 - IDE（如 VS Code）终端可能没加载你的 shell 配置，导致它启动的 shell 里
phpenv根本不可用；可在 IDE 设置里指定 shell 路径（如/bin/zsh -l）强制登录模式 - Web 服务器（如 Nginx + PHP-FPM）不走 shell 初始化流程，
php-fpm进程的php路径需手动配在 pool 配置里，和 phpenv 无关
最常被忽略的一点：phpenv 的 global 和 local 是靠 shell hook 动态拦截命令实现的，一旦 eval "$(phpenv init -)" 没跑成功，整个机制就瘫痪了；别急着查 PHP 版本，先盯住 which phpenv 和 which php 的输出路径。
