phpenv 能正常工作，前提是 PATH 和 init 两处配置都到位，缺一不可；装完不生效，90% 是因为没重载 shell 或 eval "$(phpenv init -)" 没写进正确的 shell 配置文件。
phpenv 能正常工作，前提是 PATH 和 init 两处配置都到位，缺一不可；装完不生效，90% 是因为没重载 shell 或 eval "$(phpenv init -)" 没写进正确的 shell 配置文件。
安装命令执行后为什么 phpenv 找不到？
最常见原因是 ~/.phpenv/bin 没进 PATH，或者你改了 ~/.bashrc 却在 zsh 里测试。
- 用
echo $PATH确认$HOME/.phpenv/bin是否在输出中 - 检查你当前用的 shell：
echo $SHELL，再确认修改的是对应文件（~/.bashrc、~/.zshrc或~/.profile） - 改完必须重载：
source ~/.zshrc（别只靠exec $SHELL -l，它不一定读你刚改的文件） - 如果仍报
command not found，直接运行$HOME/.phpenv/bin/phpenv --version测试二进制是否存在
phpenv init - 报错 “no such command” 怎么办？
说明克隆的仓库不完整或路径不对——phpenv init 是由 phpenv 自身的 shell shim 逻辑提供的，并非独立脚本。
- 确认克隆目标是
~/.phpenv，不是/usr/local/phpenv或其他位置（phpenv root必须能返回$HOME/.phpenv） - 运行
ls -la ~/.phpenv/bin/，应看到phpenv可执行文件；若为空，重新克隆：rm -rf ~/.phpenv && git clone https://gitcode.com/gh_mirrors/ph/phpenv ~/.phpenv - 某些镜像仓库地址带
.git后缀，但原始 repo 已去后缀，用https://gitcode.com/gh_mirrors/ph/phpenv更稳
装完 phpenv 还不能装 PHP 版本？
因为 phpenv install 不是内置命令，它依赖 php-build 插件，不装插件就只能切版本，不能装新版本。
- 装插件：
git clone https://gitcode.com/gh_mirrors/ph/php-build $(phpenv root)/plugins/php-build - 装 PHP 前先装系统依赖，Ubuntu/Debian 示例：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev - 装完版本后务必运行
phpenv rehash，否则php命令不会指向新装的版本 - 验证是否生效：
phpenv which php应输出类似~/.phpenv/versions/8.3.13/bin/php的路径
为什么 php -v 还是旧版本？
phpenv 是通过 shims 劫持命令调用的，一旦有其他 PHP 安装（如系统包管理器装的、Homebrew 装的、或手动编译的）路径排在 ~/.phpenv/shims 前面，就会绕过控制。
- 查实际执行路径：
which php—— 正常应为~/.phpenv/shims/php；如果不是，说明PATH里有更靠前的 PHP 目录 - 临时修复：把
~/.phpenv/shims放到PATH最前面，例如在~/.zshrc中写成export PATH="$HOME/.phpenv/shims:$PATH" - 项目级切换失效？确认当前目录下有
.php-version文件，且内容只有版本号（如8.3.13，不能带空格或注释）
最容易被忽略的是 shims 目录没加进 PATH，以及插件未安装导致 phpenv install 根本不可用——这两点不解决，后面所有操作都是空转。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
