Windows升级Python3.9到3.10后pip失效 如何彻底清理重装Python环境
Windows 彻底清除Python残留并重装修复方案
你遇到的如下报错:
Fatal error in launcher: Unable to create process using '"c:\users\wwwwww\appdata\local\programs\python\python37\python.exe" "C:\Users\wwwww\AppData\Local\Programs\Python\Python37\Scripts\pip.exe" install virtualenv': File not found
根源是系统残留了Python3.7/3.9的pip、virtualenv启动器,这类启动器硬编码了对应旧版本Python的安装路径,旧版本卸载后路径失效就会触发报错;Git Bash下python命令无响应、终端崩溃,是因为环境变量读取优先级命中了无效的残留Python路径,和新装的Python3.10产生冲突。按以下步骤操作即可彻底解决:
第一步:卸载所有已安装的Python程序
- 打开「设置-应用-应用和功能」,搜索框输入
Python,卸载所有搜索结果中显示的Python 3.7、3.9、3.10程序,同步卸载名为Python Launcher的组件。 - 手动删除Python默认安装目录的残留文件,涉及路径如下,存在即删除:
C:\Users\你的用户名\AppData\Local\Programs\Python(所有版本Python的核心安装目录,包含对应版本的pip、virtualenv等脚本)C:\Program Files\Python、C:\Program Files (x86)\PythonC:\Users\你的用户名\AppData\Roaming\Python(存放用户级Python配置、pip缓存、第三方脚本)
第二步:清理环境变量中的无效Python条目
- 按下Win+S搜索「编辑系统环境变量」,打开后点击窗口右下角的「环境变量」按钮
- 分别在「用户变量」「系统变量」板块找到
Path条目,双击进入编辑页 - 删除所有和Python相关的路径条目,包括各版本Python根目录、对应版本下的
Scripts目录、用户目录下Roaming里的Python脚本路径,确认后保存所有环境变量设置窗口。
第三步:清理注册表残留(可选,清理更彻底)
- 按下Win+R输入
regedit回车打开注册表编辑器 - 定位到以下两个路径,删除路径下所有名称包含Python的子项:
HKEY_CURRENT_USER\Software\PythonHKEY_LOCAL_MACHINE\SOFTWARE\Python
注意:操作前可右键对应项选择「导出」做备份,避免误删影响其他软件运行
第四步:验证清理结果
- 按下Win+R输入
cmd打开新的命令提示符窗口,分别执行python、pip、virtualenv三个命令,如果均提示「不是内部或外部命令,也不是可运行的程序或批处理文件」,说明残留清理完成。 - 关闭所有已打开的VS Code、Git Bash窗口,清空旧的环境变量缓存。
第五步:重新安装Python 3.10
- 下载对应系统架构的Python 3.10官方安装包
- 运行安装包时,必须勾选界面底部的
Add Python.exe to PATH选项,避免手动配置环境变量出错 - 若需要自定义安装路径,不要选择包含中文、特殊空格的目录,防止后续出现路径解析错误
- 安装完成后新开命令提示符窗口,执行
python --version、pip --version,正常返回3.10.x版本号即说明基础安装成功,后续执行pip install virtualenv等操作不会再出现旧路径报错,Git Bash下的python命令崩溃问题也会同步解决。
内容的提问来源于stack exchange,提问作者Kaiss B.
相关产品推荐
相关产品推荐

