Win10创建Python虚拟环境报ensurepip退出状态101如何解决

故障表现 #

执行python -m venv 自定义虚拟环境名创建虚拟环境时抛出如下报错：

Error: Command '['C:\Users\u\Desktop\venv\Scripts\python.exe', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 101.
重装Python无法解决问题，此前Python可正常运行。

排查修复步骤 #

按优先级从高到低操作，每步做完测试一次创建命令：

• 清理错误创建的虚拟环境残留，换路径测试：先把之前创建失败的C:\Users\u\Desktop\venv文件夹彻底删除，不要在桌面、C盘系统目录、Program Files这类受UAC管控的路径下创建虚拟环境，切换到D盘等非系统保护的用户目录，用普通权限（不要右键开管理员模式）打开终端执行创建命令，权限继承错乱是这个报错最高发的诱因。
• 彻底清理Python残留后重装：常规卸载Python会保留用户目录下的配置和缓存，这也是重装无效的核心原因：
  1. 正常卸载已安装的Python版本
  2. 手动删除以下路径的残留文件：
     • C:\Users\你的用户名\AppData\Roaming\Python 整个目录
     • C:\Users\你的用户名\AppData\Local\Programs\Python 下对应版本的安装目录
     • 系统环境变量、用户环境变量PATH中所有和旧Python相关的条目
  3. 重新下载官方Python安装包，安装时勾选Add Python to PATH，安装路径设置为纯英文、无空格、无特殊字符的短路径（比如D:\Python310），不要装在C盘Program Files目录下。
• 排查安全软件拦截：打开Windows安全中心-病毒和威胁防护-保护历史记录，查看是否有拦截python.exe、pip相关进程的记录，如果有把对应Python安装目录、虚拟环境存放目录加入排除项；如果装了第三方杀毒软件，临时关闭实时防护后测试。
• 排查多版本Python路径冲突：终端执行where python，确认输出的第一个Python路径是你刚安装的官方Python路径，如果存在Anaconda、Miniconda、绿色版Python路径优先级更高的情况，把官方Python的安装路径、其下的Scripts路径调整到PATH变量的最顶端，重启终端后再测试。
• 降级验证组件问题：如果上述步骤都无效，可以先创建不带pip的虚拟环境手动引导：
  执行python -m venv --without-pip test_venv创建无pip的虚拟环境，激活后执行python -m ensurepip --upgrade，根据这一步的具体报错定位缺失的系统组件即可。

内容的提问来源于stack exchange，提问作者sha