Windows下怎么用winget或choco命令行安装Python
详细介绍在Windows系统中通过winget与choco(Chocolatey)命令行工具安装Python的具体步骤、版本选择、环境验证及常见问题解决方法。
在 Windows 环境下搭建 Python 开发环境时,比起打开浏览器前往官网下载安装包、手动双击安装程序并逐项勾选配置,使用命令行包管理器是一种更加标准、快捷且可复现的方法。借助 Windows 官方自带的 winget 或成熟的第三方包管理器 Chocolatey(choco),开发者仅需一行简短的命令即可完成 Python 解释器的下载、安装及基础配置。本文将完整介绍这两种安装途径的具体操作、参数区别、环境验证以及排查技巧。
一、选型认知:winget 与 choco 的适用场景
在动手安装之前,有必要清楚了解这两个工具的运行机制与定位差异,以便根据自己的 Windows 版本和环境做出合理选择:
- winget(Windows 软件包管理器):由微软官方开发并集成在 Windows 10(1809 及以上版本)与 Windows 11 中。它的最大优势是免额外安装,且绝大多数情况下使用普通终端权限即可执行,底层直接拉取并静默运行官方分发的原生安装包。
- Chocolatey(choco):Windows 平台上建立最早、生态最丰富的第三方包管理器。适用于所有现代 Windows 客户端与 Windows Server 系统。它在安装时需要管理员特权,自动化脚本生态极度成熟,擅长统一管理依赖与系统环境变量。
二、使用 winget 命令行安装 Python
如果使用的是 Windows 10 或 Windows 11,首选推荐使用内置的 winget 工具。
步骤 1:打开终端并检查 winget
按下快捷键 Win + X,选择打开 Windows PowerShell 或 终端(Terminal)。在窗口中输入以下命令以确认 winget 已经可用:
winget --version
如果返回形如 v1.7.10861 的版本号,说明工具处于就绪状态。
步骤 2:检索确认 Python 官方包名
在安装前,可以通过搜索指令查看可用的 Python 软件包列表:
winget search Python.Python
在返回的列表中,官方原生的 Python 安装包 ID 规范为 Python.Python.<主版本号>,例如 Python.Python.3.12、Python.Python.3.11 等。
步骤 3:执行安装指令
选定所需版本后,运行以下命令开始安装(这里以稳定版 Python 3.12 为例):
winget install --id Python.Python.3.12 -e
关键参数解释:
--id:指定包的唯一标识符,避免由于名称相似匹配到其他第三方打包版本。-e(或--exact):精确匹配指定的 ID,确保安全与准确性。--scope machine(可选):默认情况下 winget 会针对当前用户安装。如果需要让系统中的所有 Windows 账户均可使用,可附加该参数(此时需以管理员权限运行终端)。
三、使用 Chocolatey(choco)命令行安装 Python
如果机器上已经部署了 Chocolatey,或者处于自动化运维脚本(如 Packer、Ansible、CI Runner)环境中,使用 choco 是非常标准的选择。
步骤 1:以管理员身份运行终端
与 winget 不同,Chocolatey 安装软件必须具备管理员权限。在开始菜单搜索“PowerShell”,右键选择“以管理员身份运行”。
步骤 2:执行安装指令
在管理员终端中输入以下命令安装 Python 最新稳定版:
choco install python -y
命令解析与实用选项:
-y(或--yes):自动接受所有安装提示与确认许可,无需中途人工敲击 Y 确认,极其适合全自动化部署。- 指定具体版本号:如果项目对版本有强制要求(例如特定 Python 3.11 小版本),可通过
--version参数锁定:choco install python --version=3.11.8 -y
四、验证安装结果与环境变量刷新
无论采用 winget 还是 choco,安装完成后最核心的一步都是让终端正确识别 Python 路径。
在重新开启的终端中,执行以下验证指令:
# 1. 验证 Python 解释器版本
python --version
# 2. 验证 pip 包管理器是否正常
pip --version
# 3. 查看 python 命令对应的物理文件路径
where.exe python
正常情况下,python --version 会正确输出如 Python 3.12.2,而 where.exe python 会列出具体的路径,例如:
C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\python.exe
C:\Users\<用户名>\AppData\Local\Microsoft\WindowsApps\python.exe
利用 Windows 自带的 Python 启动器(py.exe)
在 Windows 上,官方安装包通常会默认附带安装轻量级的 py.exe 启动器。这是一个非常实用的工具:
- 查看系统安装的所有可用 Python 版本:
py --list - 直接调用特定主次版本运行脚本:
py -3.11 script.py或py -3.12 script.py
五、常见问题排查与解决思路
问题 1:输入 python 却弹出了微软应用商店(Microsoft Store)
这是 Windows 10/11 用户最常见的问题。原因在于系统预装了名为“应用执行别名(App execution aliases)”的占位符文件,当全局 PATH 中该别名优先级高于实际安装路径时,系统就会尝试引导用户前往商店下载。
解决步骤:
- 打开 Windows 设置(快捷键
Win + I)。 - 依次进入 应用 -> 高级应用设置 -> 应用执行别名。
- 在列表中找到名为 应用安装程序(python.exe) 和 应用安装程序(python3.exe) 的开关,将其切换为关闭(Off)。
- 重新开启命令行窗口,输入
python即可恢复正常。
问题 2:提示“'python' 不是内部或外部命令,也不是可运行的程序”
说明系统的 PATH 环境变量中缺失了 Python 安装根目录及其下的 Scripts 文件夹。排查步骤如下:
- 使用
where.exe python检查是否存在输出。 - 如果找不到,可在文件资源管理器中定位实际安装路径(如
C:\Python312或%LOCALAPPDATA%\Programs\Python\Python312)。 - 按下
Win + R输入sysdm.cpl打开系统属性,在“高级”选项卡中点击“环境变量”,将 Python 安装路径及其Scripts目录追加到用户变量或系统变量的Path中。
六、常用维护命令速查
| 操作意图 | winget 对应命令 | choco 对应命令 |
|---|---|---|
| 搜索 Python 包 | winget search Python.Python |
choco search python |
| 安装默认最新稳定版 | winget install Python.Python.3.12 |
choco install python -y |
| 检查并升级已有版本 | winget upgrade Python.Python.3.12 |
choco upgrade python -y |
| 完全卸载 Python | winget uninstall Python.Python.3.12 |
choco uninstall python -y |
掌握了 winget 与 choco 这两款命令行包管理工具后,在 Windows 系统上管理 Python 开发环境就变得格外清晰和高效。对于绝大多数个人开发者,建议直接利用系统自带的 winget 保持开箱即用;而在持续集成与批量化装机场景下,choco 则能带来高度稳定的全自动化体验。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









