禁用“应用执行别名”并调整PATH顺序,即可让python命令调用本地解释器而非跳转商店。需先在设置中关闭python.exe和python3.exe的别名,再将真实Python路径(如Python312及Scripts目录)移至WindowsApps路径之前,并重启终端验证where python仅返回真实路径。

禁用“应用执行别名” + 调整 PATH 顺序,两步做完,python 就能调到你装的本地解释器,不再跳商店。
关闭 Windows 的 python.exe 应用执行别名
这是最常被忽略的第一步。Windows 10/11 默认开启这个功能,只要系统在 PATH 里没找到真实的 python.exe,就会直接重定向到 Microsoft Store 页面——它不看你的 Python 是否已安装,只看有没有匹配的可执行文件。
常见错误现象包括:
-
where python返回两条路径:一条是C:\Users\...\WindowsApps\python.exe(0KB 存根),另一条才是你安装的真实路径 - 即使勾选了 “Add Python to PATH”,CMD 仍跳商店
- 重启 CMD 后问题还在,大概率是没关别名,或关了但没重启终端
操作方式(图形界面最稳妥):
- 按
Win + I打开设置 → 搜索“管理应用执行别名” → 进入页面 - 找到
python.exe和python3.exe两项,全部关掉 - 必须关闭并重新打开 CMD 或 PowerShell,设置才生效
确保真实 Python 路径在 PATH 中优先于 WindowsApps
禁用别名只是堵住跳转入口,真正让命令生效,还得靠 PATH 正确指向你的安装目录。否则,即使别名关了,系统仍可能调用 WindowsApps 下那个假 python.exe。
关键细节:
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- 安装时务必勾选 “Add python.exe to PATH”,否则默认不写入
- 若已安装但没勾选,手动编辑系统环境变量,在
Path中添加(以 Python 3.12 为例):C:\Users\\AppData\Local\Programs\Python\Python312\ C:\Users\\AppData\Local\Programs\Python\Python312\Scripts\ - 这两行必须移到
%USERPROFILE%\AppData\Local\Microsoft\WindowsApps这一项的上方——否则顺序不对,还是先匹配到假文件
验证方式:where python 应只返回你安装的真实路径;python --version 应输出版本号。
为什么 py 启动器更可靠?
py 是 Python 官方自带的启动器,它不依赖 PATH 查找顺序,也不受 WindowsApps 干扰,且天然支持多版本切换(比如 py -3.12、py -3.11)。
使用场景:
- 你装了多个 Python 版本,又不想反复改 PATH
- 你在 CI/CD 或脚本中需要稳定调用特定版本
-
python命令仍不稳定时,py可作为临时替代
注意:py 默认随官方安装包一起安装(勾选“Add Python to PATH”时会一并加入),不需要额外配置。但如果你删过 WindowsApps 下的文件或改过注册表,py 也可能失效,此时应重装 Python 官方发行版。
最容易被忽略的是:关完别名不重启终端,或调完 PATH 不验证 where python。Windows 的 PATH 查找是严格从左到右的,而 WindowsApps 路径一旦排在前面,就永远抢在你的真实 Python 前面被调用——哪怕它只是个 0KB 的存根文件。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










