phpenv 是基于 shell 的 PHP 版本管理工具，不安装 PHP 本身，仅调度已安装版本；卸载需手动删除 ~/.phpenv、shims、全局软链及 shell 配置中的初始化代码，否则残留 PATH 注入和 hook 会导致命令异常。
phpenv 是什么，为什么不能用常规方式卸载
phpenv 不是系统级包管理器安装的 PHP 环境，而是基于 shell 的版本管理工具（类似 rbenv 或 pyenv），它本身不安装 PHP，只调度已安装的多个 PHP 版本。它不写注册表、不改系统服务，但会深度侵入 shell 初始化流程——这意味着删掉二进制文件远远不够，残留的 hook、shim 和 PATH 注入会导致后续 php 命令行为异常，甚至干扰其他环境管理工具。
删除 phpenv 本身：卸载脚本 + 手动清理路径
官方未提供 uninstall 命令，必须手动清除：
- 运行
rm -rf ~/.phpenv—— 这是主目录，含所有已安装版本（如~/.phpenv/versions/8.2.10）、插件和缓存 - 删掉 shim 目录：
rm -rf ~/.phpenv/shims（否则which php可能仍返回~/.phpenv/shims/php） - 检查并删除可能存在的全局 symlink：
ls -l /usr/local/bin/php*，若指向~/.phpenv/shims/，则rm /usr/local/bin/php* - 如果曾执行过
phpenv init并将输出写入 shell 配置，必须清理对应行（见下一条）
清除 phpenv 的 shell 注入痕迹
phpenv 的“幽灵感”主要来自它在 ~/.bashrc、~/.zshrc 或 /etc/profile.d/phpenv.sh 中插入的初始化代码。不删干净，新开终端仍会加载旧环境：
- 搜索注入痕迹：
grep -n 'phpenv' ~/.bashrc ~/.zshrc /etc/profile.d/* 2>/dev/null - 删掉整段类似这样的内容（通常包含
export PATH和eval "$(phpenv init -)"） - 执行
hash -r清空当前 shell 的命令哈希表，再新开终端验证 - 确认
type php不再显示php is a function或php is hashed
站点配置与项目级记录是否要删
phpenv 本身**不存储站点配置**，也不管理 Web 服务器或虚拟主机。所谓“站点”其实是你项目里自己写的 .php-version 文件（放在项目根目录），或 Web 服务器（如 Nginx/Apache）中硬编码的 fastcgi_pass 路径。这些都不是 phpenv 的责任范围：
立即学习“PHP免费学习笔记（深入）”；
-
.php-version文件需手动删除，否则下次进入该目录，phpenv（若还残留）会自动切换版本 - Web 服务器配置中若有
fastcgi_pass 127.0.0.1:9000或类似，跟phpenv无关，但若你当时用php-fpm配合它跑站点，需单独停用并删掉对应php-fpm配置（如/etc/php/*/fpm/pool.d/mysite.conf） -
phpenv不生成或管理php.ini，那些文件属于具体 PHP 版本安装路径，已在删~/.phpenv/versions/时一并清除
真正容易被忽略的是：即使 phpenv 全删了，php -v 仍可能成功——说明系统里还有另一个 PHP（比如 Homebrew 装的 php@8.2 或系统自带）。务必用 which php 和 php --ini 追到底层来源，否则你以为删干净了，其实只是换了个后台。
