Windows Installer检测到注册表中PythonCore残留项（如HKEY_CURRENT_USER\Software\Python\PythonCore等三处）及PATH环境变量未清空，导致误判版本已存在而中断安装。
为什么新Python安装总提示“已存在”
安装程序一启动就报错退出，或者卡在初始化阶段，大概率不是下载包损坏，而是注册表里还存着旧版本的“户口记录”。Windows Installer 会先查 HKEY_CURRENT_USER\Software\Python\PythonCore 和 HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore 下对应版本（比如 3.11 或 3.12-32）的子键；只要这些子键没被删干净，哪怕你连整个 C:\Users\Alice\AppData\Local\Programs\Python 文件夹都清空了，它也会认定“该版本已在系统中登记”，直接拒绝安装。
注册表清理必须检查的三个位置
64 位 Windows 系统上，Python 安装器可能往三处写注册表项，漏掉任意一处都会导致重装失败：
-
HKEY_CURRENT_USER\Software\Python\PythonCore—— 用户级安装（如用普通用户权限运行安装包）会写这里，常被忽略 -
HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore—— 系统级安装默认写入位置 -
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python\PythonCore—— 32 位 Python 在 64 位系统上的“兼容层”注册表镜像，必须单独检查
操作前务必点击注册表编辑器菜单栏的「文件 → 导出」，选“全部”导出备份。不要删除 HKEY_CLASSES_ROOT\Python.File，它只影响双击 .py 文件的行为，和命令行无关。
PATH 环境变量残留比注册表更常见
卸载后 where python 仍返回路径，说明环境变量没清干净——这是最常被跳过的步骤，且比注册表问题更易复现。
从 grok-build 125万行 Rust 源码深读后移植的 5 个独立 Python 模块：上下文压缩引擎、推理重试退避、崩溃恢复、钩子运行时、扩展注册表。每个模块可独立 import 或 CLI 调用。
- 打开「环境变量」窗口（右键此电脑 → 属性 → 高级系统设置 → 环境变量）
- 分别检查「系统变量」和「用户变量」里的
Path，逐条查找并删除所有含Python、AppData\Local\Programs\Python、AppData\Roaming\Python或具体路径如C:\Python312的条目 - 特别注意用户变量里隐藏的 Scripts 路径，例如
C:\Users\Alice\AppData\Local\Programs\Python\Python312\Scripts\，控制面板卸载完全不会动它 - 删完必须关闭并重新打开终端（CMD/PowerShell/VS Code 终端），否则旧 PATH 缓存仍在生效
重装前必须手动删掉的两个隐藏目录
即使注册表和 PATH 都清干净了，pip install --user 安装的包仍可能干扰新解释器，因为新 Python 默认启用 user-site：
- 运行
python -m site --user-site（如果还能执行）或直接去%APPDATA%\Python\找对应版本文件夹，例如%APPDATA%\Python\Python312，整目录删除 - 顺手清掉
%APPDATA%\pip\和%LOCALAPPDATA%\pip\Cache\，避免 pip 用旧缓存装错包 - 安装新 Python 时，务必勾选
Add Python to PATH；首次运行后建议执行pip config unset global.index-url（不是gl），防止旧 pip 配置残留影响源地址
注册表清理本身不难，难的是确认是否真清完了——最稳妥的验证方式是：重启终端后运行 where python 和 Get-Command python 均无输出，且新安装包能顺利通过初始检测页。任何一处残留，都可能让整个重装流程卡在无声无息的地方。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
