在Windows或macOS上安装Python时，不少人会遇到安装向导进度条突然停止响应的情况。表面上看安装程序似乎还在运行，但百分比数字几分钟甚至十几分钟都不变化，取消按钮也变灰无法点击。这种现象通常不是电脑性能不足，而是安装器在拉取组件包或者写入临时文件时发生了阻塞。下面介绍一套经过验证的处理思路，帮助你在不重装系统的前提下恢复正常安装。
一、为什么进度条会卡住
Python官方安装包（如python-3.11.exe）在启动后，会先解压自身到系统临时目录，然后尝试从网络下载pip、setuptools等可选组件。如果此时网络波动、代理配置异常，或者临时目录中已存在同版本但不完整的缓存文件，安装器就会在等待响应中停滞。另外一种常见原因是系统权限不足，安装器无法覆盖某些受保护的目录，但界面上没有抛出明确错误。
还有一个容易被忽略的点：上一次强制关闭安装器后，后台可能残留了Python Software Foundation相关的进程。这些进程依然占用着临时文件句柄，导致你再次启动安装包时，新进程无法写入同名文件，从而卡在初始阶段。因此，单纯重新运行安装程序往往无效。
二、结束相关进程释放占用
第一步应当是清理残留进程。在Windows上按下Ctrl+Shift+Esc打开任务管理器，切换到“进程”选项卡，查找名称中包含“Python”、“pip”或安装器exe名称的条目。选中后点击“结束任务”。如果安装器是以管理员启动的，也需要确认是否有提权后的子进程仍在运行。
你也可以通过命令行一次性结束，避免图形界面漏掉隐藏进程。以下批处理思路可供参考：
@echo off
REM 结束可能残留的Python安装相关进程
tasklist | findstr /i "python" > nul
if %errorlevel% == 0 (
taskkill /f /im python*.exe
)
tasklist | findstr /i "exe" > nul
if %errorlevel% == 0 (
taskkill /f /im *install*.exe
)
echo 进程清理完成
在macOS或Linux中，可以使用ps配合grep找到进程号，再用kill -9终止。确保没有python开头的安装脚本在后台驻留，再进入下一步。
三、清理系统缓存与临时文件
进程结束后，临时目录里的损坏缓存必须删掉。Windows的临时目录通常位于C:Users你的用户名AppDataLocalTemp，打开后删除所有以“Python”开头或包含版本号如“3.11”的文件夹。也可以使用系统自带的磁盘清理工具，勾选“临时文件”进行批量处理。
如果安装器是从Microsoft Store获取的，还要清理Store的缓存。可按下Win+R输入wsreset.exe回车，让商店重置缓存后再试。对于pip层面的缓存，可在命令行执行以下指令：
# 清理pip下载缓存 python -m pip cache purge # 若python命令不可用，直接删除用户目录下的pip缓存文件夹 # Windows: %LocalAppData%pipCache # macOS: ~/Library/Caches/pip
清理完成后建议重启一次电脑，让系统释放所有文件锁。虽然不重启多数情况也能继续，但重启能最大限度避免未知占用。
四、重新安装与避坑设置
重新运行安装包时，不要直接双击默认安装。建议右键“以管理员身份运行”，在第一个界面勾选“Add Python to PATH”，然后选择“Customize installation”进入自定义。在可选功能页，如果网络环境差，可取消勾选“pip”和“Documentation”，先让解释器本体装好，后续再用离线whl安装pip。
若进度条依旧缓慢，可改用离线安装包。访问ipipp.com镜像站下载完整嵌入版（embedded zip），解压即可用，完全跳过联网进度条。以下代码演示如何用已解压的嵌入式Python安装pip：
import os
import subprocess
# 假设嵌入式Python解压在 D:pyembed
python_exe = r"D:pyembedpython.exe"
# 下载get-pip脚本后本地安装
subprocess.run([python_exe, "-m", "ensurepip", "--upgrade"])
print("pip已通过本地方式就绪")
最后提醒，部分杀毒软件会实时扫描写入的pyd文件导致卡顿，安装期间可临时将临时目录加入白名单。按照上述结束进程、清缓存、换方式的流程，绝大多数Python安装进度条卡死问题都能解决。
Python_installprogress_bar_stuckcache_cleanup修改时间：2026-08-03 13:30:22