重装或迁移phpenv需先清理残留路径、避免多版本冲突、确保shim机制接管php命令；执行which php、php --ini、phpenv root确认现状，再按系统类型清除干扰源，最后重新安装并验证shim生效。
重装或迁移 phpenv 不是“卸载再装”那么简单——核心在于清理残留路径、避免多版本冲突、确保 shim 机制重新接管 php 命令。直接覆盖安装大概率导致 which php 指向错误位置，或 php -v 与 phpinfo() 版本不一致。
先确认当前 php 是谁在管
别急着删，先搞清现状。执行这三条命令，记下输出：
-
which php—— 看命令实际来自哪（可能是系统包、Homebrew、源码编译，或旧 phpenv 的 shim） -
php --ini—— 查Loaded Configuration File路径，确认 php.ini 是否还连着旧版本 -
phpenv root—— 如果已装 phpenv 但失效，这里可能报错；若返回/home/xxx/.phpenv或类似路径，说明旧安装还在
只要 which php 输出不是 ~/.phpenv/shims/php，就说明 phpenv 没真正接管，重装前必须清理。
彻底清理旧 phpenv 和干扰项
常见干扰源有三类：系统包管理器装的 PHP、手动编译残留、以及旧 phpenv 自身。按顺序处理：
立即学习“PHP免费学习笔记（深入）”；
- Linux（Debian/Ubuntu）：
sudo apt purge $(dpkg -l | grep 'php[0-9]\+' | awk '{print $2}') 2>/dev/null || true，再sudo rm -rf /usr/bin/php* /usr/lib/php /etc/php* - Linux（CentOS/RHEL）：
sudo yum remove $(rpm -qa | grep php) && sudo rm -rf /etc/php.d/ /etc/php*/ /usr/lib64/php/ - macOS（Homebrew）：
brew uninstall --force php && brew cleanup，再检查ls -la /usr/local/bin/php*是否还有残留链接 - 所有系统都执行：
rm -rf ~/.phpenv，并从~/.bashrc、~/.zshrc或~/.profile中删掉所有含phpenv init或PATH=.*phpenv的行
清理后运行 which php 应该无输出，php -v 报 command not found 才算干净。
全新安装 phpenv 并验证 shim 生效
推荐用 git 克隆方式（比 installer 更可控），并立即启用插件支持构建：
- 克隆：
git clone https://github.com/phpenv/phpenv.git ~/.phpenv - 安装 php-build 插件：
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build - 配置 shell：
echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.zshrc（zsh 用户）或~/.bashrc（bash 用户） - 启用 shim：
echo 'eval "$(phpenv init -)"' >> ~/.zshrc，然后exec $SHELL -l - 验证：
phpenv --version有输出，且which php返回~/.phpenv/shims/php
注意：phpenv init - 输出里必须包含 export PATH="~/.phpenv/shims:$PATH"，否则 shim 不生效——这是最常被忽略的一环。
迁移旧项目 PHP 版本配置
你不需要重新安装所有旧版本。只需把原 ~/.phpenv/versions/ 下对应目录整个复制过来，再执行 phpenv rehash：
- 如果旧环境还能进，直接
cp -r ~/.phpenv/versions/7.4.33 ~/.phpenv/versions/ - 如果旧环境已毁，但备份了
.php-version文件，就用phpenv install 7.4.33重装（需提前装好依赖如libxml2-dev、openssl-dev等） - 项目级切换：
cd /path/to/project && phpenv local 7.4.33，会自动生成.php-version文件 - 别忘了检查
php -m输出是否含必需扩展；缺失的用phpenv install --reinstall 7.4.33+ 对应PHP_BUILD_CONFIGURE_OPTS参数重编译
真正容易出问题的不是安装动作本身，而是 shims 目录没被 PATH 优先命中，或者 .php-version 文件权限为只读导致 phpenv 读不到——遇到版本不切换，先看这两个地方。
