卸载php后需手动清理环境变量path中的残留路径,包括系统和用户变量、启动脚本及powershell配置文件,否则终端仍可调用旧php.exe或报错;清理后须彻底关闭并重启所有终端进程才能生效。

PHP 卸载后,环境变量里的 PATH 不会自动清理,必须手动删掉残留的 PHP 路径,否则终端仍能调用旧 php.exe 或报错“找不到指定模块”。
怎么查当前 PATH 里有没有残留 PHP 路径
打开命令提示符(CMD)或 PowerShell,运行:
echo %PATH%
或者在 PowerShell 中更清晰地分行显示:
$env:PATH -split ';' | Select-String php
常见残留路径包括:C:\php、C:\xampp\php、C:\wamp64\bin\php\php8.1.12、C:\laragon\bin\php\php-8.2.0 等。只要看到含 php 的目录,就需处理。
立即学习“PHP免费学习笔记(深入)”;
Windows 图形界面下修改系统 PATH 的正确步骤
不能直接编辑注册表或靠第三方工具“一键清理”,容易误删。应走标准系统设置流程:
- 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在“系统变量”区域找到
Path,双击打开 - 逐条查找含
php的条目(注意区分大小写不敏感,但路径名通常小写) - 选中后点“删除”,不是清空整个
Path—— 否则会导致cmd、ping等基础命令失效 - 确认所有 PHP 相关路径都已移除后再点“确定”
改完 PATH 后命令行还识别 php?重启终端还不够
新 PATH 设置不会自动同步到已打开的终端进程,必须彻底关闭并重开 CMD/PowerShell/IDE 内置终端。更稳妥的做法是:
- 关闭所有终端窗口(包括 VS Code、PhpStorm 的内置 Terminal)
- 任务管理器中结束
cmd.exe、powershell.exe、WindowsTerminal.exe进程 - 重新打开终端,再运行
where php(Windows)或which php(WSL)验证是否真无结果 - 如果仍返回路径,说明有其他地方注入了 PATH:检查
AutoRun注册表项(HKEY_CURRENT_USER\Software\Microsoft\Command Processor\AutoRun)、用户级环境变量、或 IDE 自带的 shell 配置
额外风险点:别忽略用户级 PATH 和脚本注入
系统级 Path 清理完不代表万事大吉:
- 用户变量里的
Path也可能单独加过 PHP 路径,同样要在“环境变量”窗口里检查“用户变量”区域 - 某些安装包(如 Laragon、XAMPP)会在
%USERPROFILE%\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup放启动脚本,动态追加 PATH - PowerShell 的
$PROFILE文件(如$HOME\Documents\PowerShell\Microsoft.PowerShell_profile.ps1)可能有$env:PATH += ';C:\php'类语句,需手动注释或删除
这些地方不清理,下次开终端还是旧 PHP —— 很多人卡在这一步,反复以为卸载失败。











