一、前言：一次踩完所有Python环境坑的崩溃经历

最近重装开发环境，自定义路径安装Python到D:\devenv\sdk\python，接连踩了全套经典报错，折腾3小时才全部根治：

1. CMD输入python --version跳微软商店，提示Python was not found；
2. 修复python命令后，输入pip直接报错：'pip' 不是内部或外部命令；
3. 想卸载重装，控制面板卸载弹出0x80070643，卸载失败；
4. 安装新一代包管理器uv后，uvx命令同样无法识别。

网上大部分教程只单独解决某一个报错，遇到连环问题完全失效。本文整合全套修复流程，覆盖自定义路径、系统环境、安装卸载、uv工具配置，新手照着一步步操作即可永久解决。

二、报错1：python --version 提示Python was not found

报错截图

C:\Windows\System32>python --version
Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings > Apps > Advanced app settings > App execution aliases.

根本原因

Windows自带应用执行别名，系统拦截本地python，强制跳转微软商店，哪怕你本地完整安装Python也识别不到。

一步修复

1. 快捷键 Win + I 打开系统设置
2. 选择 应用 → 高级应用设置 → 应用执行别名
3. 找到两个开关，全部关闭：
   • python.exe
   • python3.exe
4. 关闭所有CMD/PowerShell终端，重新打开验证：

python --version

正常输出版本号即修复完成。

三、报错2：python能运行，但pip提示不是内部或外部命令

报错现象

python命令正常执行，输入pip直接提示：

'pip' 不是内部或外部命令，也不是可运行的程序或批处理文件。

很多人误区：以为site-packages/pip文件夹就是pip可执行程序，完全搞错！

• D:\devenv\sdk\python\Lib\site-packages\pip：pip源码包，不能直接cmd调用
• D:\devenv\sdk\python\Scripts\pip.exe：全局可执行文件，系统必须识别这个路径

全套修复方案（分3步）

步骤1：先确认你的Python真实路径

CMD执行命令获取安装目录：

python -c "import sys;print(sys.executable)"

输出示例（我的自定义路径）：
D:\devenv\sdk\python\python.exe
拼接出两条关键路径：

1. Python根目录：D:\devenv\sdk\python
2. Scripts目录（存放pip.exe）：D:\devenv\sdk\python\Scripts

步骤2：手动添加系统环境变量（根治核心）

1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
2. 在系统变量找到Path，双击编辑
3. 点击「新建」，依次粘贴两条路径：

D:\devenv\sdk\python
D:\devenv\sdk\python\Scripts

4. 所有窗口全部点击确定，彻底关闭所有终端再重新打开

避坑提醒：只添加用户变量会失效，必须添加系统变量；路径末尾不要带\。

步骤3：Scripts缺失pip.exe强制重建

打开Scripts文件夹，若里面没有pip.exe，管理员CMD执行：

python -m ensurepip --upgrade --default-pip

执行完成后刷新文件夹，自动生成pip、pip3可执行文件。

永久应急方案（不想改环境变量直接用）

无论环境变量怎么崩，这条命令永远生效，替代所有pip操作：

# 查看pip版本
python -m pip --version
# 安装第三方库
python -m pip install requests
# 升级pip
python -m pip install --upgrade pip

四、报错3：卸载Python提示错误代码0x80070643

报错原因

MSI安装注册表损坏、安装缓存丢失、文件残缺，控制面板卸载程序无法匹配原始安装记录。按优先级执行方案。

方案1：修复安装后卸载（成功率最高）

1. 官网下载和当前版本完全一致的Python安装exe
2. 右键安装包 → 以管理员身份运行
3. 选择Repair修复现有Python环境
4. 修复完成直接点击Uninstall卸载，流程正常走完

方案2：微软官方卸载修复工具

微软官方工具专门修复安装/卸载注册表损坏问题：

1. 下载地址：微软 Program Install and Uninstall Troubleshooter
2. 运行工具，选择「卸载」
3. 列表选中所有Python、Python Launcher条目，自动清理损坏注册表

方案3：命令行强制卸载（管理员CMD）

# 卸载Python主程序
wmic product where name like "Python 3.%" call uninstall
# 卸载启动器
wmic product where name like "Python Launcher%" call uninstall

方案4：手动彻底清理（前三种失效再操作）

1. 删除本地Python文件夹

D:\devenv\sdk\python
C:\Users\用户名\AppData\Local\Programs\Python
C:\Users\用户名\AppData\Roaming\Python

2. 清理注册表（操作前建议导出备份）
   Win+R输入regedit，删除以下项：

HKEY_CURRENT_USER\Software\Python
HKEY_LOCAL_MACHINE\SOFTWARE\Python
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python

3. 环境变量删除所有Python、Scripts相关路径，重启电脑

五、报错4：‘uvx’ 不是内部或外部命令

报错说明

uv/uvx不属于Python自带工具，是新一代高性能包管理器，pip安装后可执行文件存放在Scripts目录，Scripts未加入PATH就会识别失败。

两种安装方式

方式1：PowerShell一键安装（推荐，自动配置环境）

以管理员身份打开PowerShell，执行：

irm https://astral.sh/uv/install.ps1 | iex

安装完成关闭全部终端，重新打开即可直接使用uvx。

方式2：pip手动安装（已有Python环境）

python -m pip install uv

安装后uv.exe、uvx.exe出现在D:\devenv\sdk\python\Scripts，只要Scripts目录已加入系统PATH，命令全局生效。

临时调用（环境变量未配置时）

python -m uvx xxx

六、一劳永逸：Python正确安装规范，从源头避免所有报错

1. 下载官网64位安装包，右键管理员运行
2. 安装界面必须勾选 Add Python to PATH，自动配置两条路径
3. 自定义安装路径推荐D盘非系统目录，如D:\devenv\sdk\python
4. 安装完成后，先关闭微软商店Python别名，再打开CMD验证
5. 不要手动删除Python文件夹卸载，优先使用安装包Repair+Uninstall

七、万能应急命令合集（收藏备用）

Python相关

# 查看python版本
python --version
# 不依赖环境变量调用pip
python -m pip install xxx
# 重建pip可执行文件
python -m ensurepip --upgrade
# Windows官方启动器（不受商店拦截）
py --version
py -m pip list

uv工具相关

# 安装uv
python -m pip install uv
# 运行uv工具
uvx xxx
# 临时调用uvx
python -m uvx xxx

卸载修复

# 强制卸载Python
wmic product where name like "Python 3.%" call uninstall
# 重置Windows安装服务
msiexec /unregister
msiexec /regserver

八、总结

Windows Python环境99%的报错根源只有两个：

1. 微软商店别名拦截python命令；
2. Scripts目录未添加到系统PATH，pip、uvx等可执行文件无法全局调用。

遇到卸载失败0x80070643，优先修复安装再卸载，不要直接手动删文件夹，会残留注册表导致后续重装持续翻车。

本文覆盖新手90%会踩的全套环境坑，收藏此文，以后配置Python环境直接对照操作，不用再到处搜零散解决方案。

---