Windows下怎么用winget或choco命令行安装Python

程一诺
程一诺
发布时间:2026-11-14 | 4人浏览过
原创

详细介绍在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 系统。它在安装时需要管理员特权,自动化脚本生态极度成熟,擅长统一管理依赖与系统环境变量。
Windows下怎么用winget或choco命令行安装Python
图 1:winget 与 choco 的特性、权限与选型定位对照

二、使用 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 账户均可使用,可附加该参数(此时需以管理员权限运行终端)。
Windows下怎么用winget或choco命令行安装Python
图 2:通过 winget 检索、精确匹配与安装验证的时序步骤

三、使用 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
Windows下怎么用winget或choco命令行安装Python
图 3:Chocolatey 包处理、安装目录落盘与 PATH 环境变量自动维护

四、验证安装结果与环境变量刷新

无论采用 winget 还是 choco,安装完成后最核心的一步都是让终端正确识别 Python 路径。

重要提示:安装完成后,请务必关闭当前正在使用的终端窗口,并重新开启一个新的终端。因为当前已经打开的终端窗口保留的是启动那一刻的环境变量副本,无法自动读取安装器写入注册表的新 PATH 路径。

在重新开启的终端中,执行以下验证指令:

# 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 中该别名优先级高于实际安装路径时,系统就会尝试引导用户前往商店下载。

解决步骤:

  1. 打开 Windows 设置(快捷键 Win + I)。
  2. 依次进入 应用 -> 高级应用设置 -> 应用执行别名。
  3. 在列表中找到名为 应用安装程序(python.exe) 和 应用安装程序(python3.exe) 的开关,将其切换为关闭(Off)。
  4. 重新开启命令行窗口,输入 python 即可恢复正常。

问题 2:提示“'python' 不是内部或外部命令,也不是可运行的程序”

说明系统的 PATH 环境变量中缺失了 Python 安装根目录及其下的 Scripts 文件夹。排查步骤如下:

  1. 使用 where.exe python 检查是否存在输出。
  2. 如果找不到,可在文件资源管理器中定位实际安装路径(如 C:\Python312 或 %LOCALAPPDATA%\Programs\Python\Python312)。
  3. 按下 Win + R 输入 sysdm.cpl 打开系统属性,在“高级”选项卡中点击“环境变量”,将 Python 安装路径及其 Scripts 目录追加到用户变量或系统变量的 Path 中。
Windows下怎么用winget或choco命令行安装Python
图 4:常见命令行环境异常、原因分析与针对性解决策略

六、常用维护命令速查

操作意图 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 则能带来高度稳定的全自动化体验。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表