1. 为什么你需要Chocolatey来安装Python?
如果你是一个Windows用户,并且刚刚开始接触编程,或者你是一个需要在多台Windows机器上快速部署开发环境的老手,那么“安装Python”这件事,很可能就是你遇到的第一个小门槛。传统的安装方式是什么?打开浏览器,搜索“Python官网”,找到下载页面,在一堆版本号里选择一个,下载一个几十兆的安装包,然后双击运行,小心翼翼地勾选“Add Python to PATH”这个至关重要的选项,最后点下一步、下一步……整个过程不仅耗时,而且容易出错,尤其是那个“PATH”环境变量,没勾选上,后面一堆命令都用不了,新手直接卡住。
更麻烦的是,当你需要安装其他开发工具,比如Node.js、Git、Docker Desktop时,你又得重复一遍这个“搜索-下载-安装-配置”的循环。时间就这么一点点被浪费掉了。我自己在带新人的时候,就经常遇到他们因为环境配置问题卡半天,非常影响学习效率和热情。
这时候,Chocolatey 就该登场了。你可以把它理解为Windows上的“软件商店命令行版”,或者一个超级强大的“包管理器”。它的核心思想是:用一条命令,安装、升级、卸载软件。想装Python?没问题,打开命令行,输入 choco install python3,回车,然后去喝杯咖啡,回来就好了。环境变量?Chocolatey帮你自动配好。依赖库?比如Python运行需要的Visual C++ Redistributable,它也一并给你装好。整个过程全自动,标准化,几乎不可能出错。
我用了Chocolatey好几年,最大的感受就是“省心”和“可重复”。给团队新电脑配置环境,我不用再写一份冗长的图文安装手册,只需要发一个脚本文件,里面是几条 choco install 命令,一键执行,所有人的环境都一模一样。这对于保证开发环境的一致性,避免“在我机器上是好的”这种问题,有奇效。所以,无论你是想摆脱繁琐的手动安装,还是追求高效、一致的环境管理,Chocolatey都是Windows平台上一个不可或缺的神器。接下来,我就手把手带你,用这个神器,在5分钟内从零开始,搭建好一个能跑起来的Python3开发环境。
2. 前期准备:安装与配置Chocolatey
万事开头难,但安装Chocolatey本身,却简单得超乎想象。它本质上是一个基于PowerShell的脚本工具,所以我们需要一个合适的命令行环境来执行安装命令。
2.1 启动管理员权限的PowerShell
这是最关键的一步。因为Chocolatey需要向系统目录(如 C:\ProgramData)写入文件以及修改系统环境变量(PATH),所以必须拥有管理员权限。
- 在Windows 10或11的搜索框里,直接输入 “PowerShell”。
- 在搜索结果中的“Windows PowerShell”上,不要直接点击,而是右键点击它,然后选择 “以管理员身份运行”。你会看到一个用户账户控制的弹窗,点击“是”即可。
你会看到一个背景为蓝色,提示符路径前有“管理员”字样的窗口。我们的所有操作都将在这里进行。我强烈建议你每次都这样打开,养成好习惯,能避免很多因权限不足导致的奇怪错误。
2.2 执行一键安装命令
在打开的管理员PowerShell窗口中,我们需要执行Chocolatey官方的安装脚本。这个脚本会检测你的系统环境,然后自动完成所有安装步骤。
将下面这条命令完整地复制粘贴到PowerShell窗口里,然后按回车:
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
看起来有点长,别怕,我们拆解一下这条命令在干什么:
Set-ExecutionPolicy Bypass -Scope Process -Force;:这一部分是临时放宽当前PowerShell会话的执行策略,允许运行远程脚本。这只是一个临时设置,不会影响你系统的全局安全策略,关闭窗口后就失效了。[System.Net.ServicePointManager]::SecurityProtocol...:这一部分是确保PowerShell使用安全的TLS协议(如TLS 1.2)去下载文件,避免因为协议过旧而连接失败。- 最后一部分
iex (...DownloadString('...')):这才是核心,它从Chocolatey的官方服务器下载安装脚本,并立即执行(iex是Invoke-Expression的缩写)。
执行后,你会看到屏幕上开始滚动输出信息,显示下载和安装的进度。整个过程是全自动的,你不需要进行任何交互。直到最后出现类似“Chocolatey installed successfully!”的提示,就大功告成了。
2.3 验证安装与基础命令
安装完成后,为了确保一切正常,我们最好做个快速验证。关闭当前的管理员PowerShell窗口,然后重新以管理员身份打开一个新的。这一步很重要,是为了让新安装的Chocolatey命令能够被当前会话识别。
在新的窗口里,输入以下命令:
choco -?
或者
choco --version
如果安装成功,choco -? 会输出一大串帮助信息,告诉你各种命令怎么用;choco --version 则会直接显示当前安装的Chocolatey版本号,比如 1.3.0。看到这些,就说明你的Chocolatey已经整装待发了。
这里给你分享几个我常用的,也是最基本的Chocolatey命令,你可以先混个眼熟:
choco search <关键词>:搜索软件包,比如choco search python会列出所有包含python的包。choco list:列出本地已经通过Chocolatey安装的所有软件。choco upgrade all -y:一键升级所有已安装的软件(-y参数表示自动确认所有提示,非常省事)。
好了,基础设施Chocolatey已经搭建完毕。有了它,我们安装Python就像在应用商店点一下“获取”那么简单。接下来,就是见证奇迹的时刻。
3. 核心实战:一条命令安装Python3
环境准备好了,安装Python就是水到渠成的事情。用Chocolatey安装软件,你通常不需要关心软件官网在哪里,哪个版本稳定,安装包有多大,依赖库怎么装。它都帮你打理好了。
3.1 搜索与确认Python包
虽然我们知道包名大概率是 python3 或者 python,但养成先搜索的好习惯总没错。这能帮你找到官方维护的、最推荐的包,避免安装一些社区维护的、可能过时的版本。
在管理员PowerShell中,输入:
choco search python
你会看到一个很长的列表,里面包含 python、python3、python2、python311(特定小版本)以及 python.install 等众多包。这里有个小知识:在Chocolatey的约定里,以 .install 结尾的包通常是该软件的“纯净”安装包,而省略了 .install 的同名包可能是一个“元包”,它本身不包含文件,只是依赖于 .install 包,这样设计是为了方便版本管理。
对于大多数用户,我们直接安装 python3 这个包就行。它是Python软件基金会官方维护的包,会自动安装当前推荐的稳定版本(比如写作时是3.11.x)。你可以通过以下命令查看这个包的详细信息:
choco info python3
这个命令会输出包的描述、当前版本、维护者、下载量等,让你吃个定心丸。
3.2 执行安装命令并理解过程
确认无误后,就可以运行那条“魔法命令”了:
choco install python3 -y
再次强调 -y 参数,它代表对所有安装过程中的确认提示(比如“你接受许可协议吗?”)自动回答“是”。这能让你真正实现无人值守的一键安装。如果不加 -y,安装过程可能会暂停,等待你手动输入 Y 再按回车。
当你按下回车后,屏幕上会开始刷屏。别慌,这是Chocolatey在辛勤工作。我带你解读一下典型输出:
- 依赖解析与下载:Chocolatey首先会分析
python3这个包需要哪些依赖。对于Python来说,它很可能需要一些Windows系统更新补丁(如KB开头的包)和Visual C++运行库(vcredist140等)。你会看到它开始并行下载这些依赖包,显示进度百分比。这是手动安装时最容易忽略但导致运行错误的关键环节,Chocolatey帮你全解决了。 - 安装依赖:下载完成后,它会逐个安装这些依赖。你可能会看到一些提示,比如“此更新不适用于当前操作系统”,这是正常的,Chocolatey会智能跳过。
- 安装Python主体:依赖处理完后,开始下载并安装Python本体。你会看到它从官方源拉取Python的Windows安装程序(.exe)。
- 静默安装与配置:Chocolatey会使用静默参数(
/quiet)运行这个安装程序。最关键的一步来了:它会自动帮你勾选上“Add Python to PATH”这个选项,并将Python安装到C:\Python39(以3.9为例)或类似的标准路径。这是手动安装时新手最容易踩的坑,现在完全自动化了。 - 环境刷新:安装完成后,输出信息里会有一行非常重要的提示:
Environment Vars (like PATH) have changed. Close/reopen your shell to see the changes (or in powershell/cmd.exe just typerefreshenv)。意思是环境变量已经修改,你需要新开一个命令行窗口,或者在当前窗口输入refreshenv命令来刷新环境变量,这样系统才能找到刚安装的python命令。
整个安装过程,网络通畅的话,大概也就几分钟。你完全可以在它运行的时候去处理别的事情。相比手动安装的步步惊心,这种体验堪称优雅。
3.3 安装后的验证与常见问题处理
安装脚本跑完,最后显示“Chocolatey installed X/X packages. The install of python3 was successful.”,就表示成功了。但我们还得亲自验证一下。
首先,按照提示,关闭当前的管理员PowerShell,再重新打开一个新的(或者输入 refreshenv)。然后,输入以下命令:
python --version
如果一切顺利,你会看到类似 Python 3.11.4 的输出。恭喜你,Python已经成功安装并配置好了!
再输入:
pip --version
你应该能看到pip(Python的包管理工具)的版本信息,这说明pip也一并安装好了。
万一没成功怎么办? 别急,我分享几个我踩过的坑和解决办法:
- 命令未找到:如果输入
python或pip提示不是命令,大概率是环境变量没生效。请务必确保你是在安装完成后新打开的命令行窗口,或者执行了refreshenv命令。 - 安装中断或报错:最常见的原因是网络问题,导致某个依赖包下载失败。你可以尝试重新运行
choco install python3 -y,Chocolatey有断点续传和缓存机制。如果某个包反复失败,可以尝试先单独安装它,比如choco install vcredist140 -y。 - 权限问题:如果你不是在管理员权限的PowerShell中运行安装命令,肯定会失败。请回头检查第一步。
- 查看详细日志:Chocolatey的所有操作都有日志,存放在
C:\ProgramData\chocolatey\logs\目录下。如果遇到诡异问题,查看日志文件是定位问题最快的方法。
走到这一步,你的Windows系统已经拥有了一个功能完整、配置妥当的Python环境。但这还不是终点,我们得让它真正“跑起来”,写出第一个程序。
4. 从安装到运行:你的第一个Python程序
环境装好了,就像新电脑开了机,我们得打个“Hello World”试试,确保所有部件都工作正常。这个过程我们会用到两种最常用的方式:交互式命令行和运行脚本文件。
4.1 验证Python交互式环境
这是最直接、最快速的验证方法。在刚才已经验证过 python --version 的PowerShell窗口里(普通用户权限即可,不需要管理员了),直接输入:
python
回车后,你会发现命令提示符从 PS C:\> 变成了 >>>。这表示你已经进入了Python的交互式解释器(REPL)。这是一个即写即得的沙盒环境,你输入的每一行Python代码都会被立即执行并显示结果。
在 >>> 提示符后,输入那句经典的咒语:
print("Hello, World! I'm from Chocolatey!")
按下回车,你会在下一行立刻看到输出:Hello, World! I'm from Chocolatey!。这证明Python解释器工作完全正常,能够接收、执行代码并输出结果。你可以在这里尝试一些简单的计算,比如 3 + 5 * 2,或者 import this 看看Python之禅,随意玩一下。要退出交互模式,输入 exit() 或者按 Ctrl+Z 再按回车(Windows下)即可。
4.2 创建并运行你的第一个Python脚本文件
交互式环境适合做实验,但真正的编程工作是在脚本文件中完成的。我们来创建一个真正的Python程序文件。
-
选择工作目录:首先,找一个你喜欢的地方作为项目目录。比如在
D:\盘下新建一个文件夹叫my_python_projects。在PowerShell中,使用cd命令切换到这个目录:cd D:\my_python_projects -
创建Python文件:我们将使用PowerShell来创建一个新文件。输入以下命令:
New-Item hello_chocolatey.py -Type File这条命令会在当前目录创建一个名为
hello_chocolatey.py的空文件。.py扩展名告诉系统这是一个Python脚本。 -
编辑文件内容:我们需要用文本编辑器往里面写代码。如果你系统里有VS Code、Notepad++等专业编辑器,可以直接用它们打开。这里我们用Windows自带的记事本做一个简单演示:
notepad hello_chocolatey.py记事本打开后(可能是空白的),输入以下代码:
# 这是我的第一个Python脚本,通过Chocolatey安装的环境运行! print("=== Hello from Chocolatey Python! ===") name = input("What's your name? ") print(f"Nice to meet you, {name}!") print(f"The Python version you're using is: {sys.version}")注意,我们故意在最后一行用了一个未导入的模块
sys,等下会看到错误。输入完成后,保存文件并关闭记事本。 -
运行脚本:回到PowerShell,确保你在
hello_chocolatey.py文件所在的目录,然后运行:python hello_chocolatey.py程序会首先打印欢迎信息,然后等待你输入名字。你输入名字并按回车后,它会打招呼,然后在最后一行报错:
NameError: name 'sys' is not defined。这很好,说明程序在运行,并且错误提示是清晰的。 -
修复并完善脚本:我们修复这个错误,并让程序更健壮。再次用记事本打开文件,将内容修改为:
# 这是我的第一个Python脚本,通过Chocolatey安装的环境运行! import sys # 导入sys模块来获取版本信息 print("=== Hello from Chocolatey Python! ===") name = input("What's your name? ") print(f"Nice to meet you, {name}!") # 使用sys模块获取版本信息 version_info = sys.version_info print(f"\nYou are using Python {version_info.major}.{version_info.minor}.{version_info.micro}") print("Your Python executable is at:", sys.executable) # 一个简单的小功能:计算名字的长度 name_length = len(name) print(f"By the way, your name has {name_length} character{'s' if name_length != 1 else ''}.")保存并关闭。再次运行
python hello_chocolatey.py。这次,你会看到一个更完整、更友好的交互程序。它展示了输入、输出、字符串格式化、模块导入和简单计算。
4.3 探索更多:使用pip安装第三方库
一个光秃秃的Python解释器用处有限,Python生态的强大在于海量的第三方库。而安装这些库的工具 pip,已经随着Python一起安装好了。让我们来试试安装一个非常流行且实用的库:requests,它用于发送HTTP请求。
在PowerShell中(任意目录),输入:
pip install requests
你会看到pip开始从Python官方的软件仓库下载 requests 库及其依赖。安装完成后,我们可以写一个小脚本来测试它。新建一个文件叫 test_request.py:
import requests
# 尝试访问一个公开的API来测试网络和库是否正常
print("Testing requests library...")
try:
response = requests.get("https://api.github.com")
# 检查HTTP状态码,200表示成功
if response.status_code == 200:
print("Success! The requests library is working perfectly.")
print(f"GitHub API responded in {response.elapsed.total_seconds():.2f} seconds.")
else:
print(f"Got an unexpected status code: {response.status_code}")
except Exception as e:
print(f"Something went wrong: {e}")
运行这个脚本 python test_request.py。如果网络通畅,你会看到成功的消息。这证明了你的Python环境不仅能运行基础代码,还能通过pip扩展功能,接入广阔的Python生态。
至此,你已经完成了从零开始,使用Chocolatey一键部署Python3开发环境,并验证了从基础解释器到运行脚本、再到安装第三方库的完整链路。整个过程丝滑流畅,几乎没有手动配置的环节。这种效率的提升,在你未来需要管理多个项目、配置多台机器时,感受会愈发深刻。记住这个组合:Chocolatey for Windows, pip for Python,它们能帮你把环境管理的琐事降到最低,让你更专注于代码和创意本身。
317



被折叠的 条评论
为什么被折叠?



