Windows和Mac怎么免费安装Python开发环境
面向新手的完整实用指南,手把手讲解在 Windows 与 Mac 系统上免费安装官方 Python 解释器、配置环境变量与设置免费代码编辑器 VS Code 的全流程。
准备学习编程或尝试自动化办公时,许多初学者常常卡在第一步:网上的教程五花八门,有的推销付费开发软件,有的步骤繁杂且缺乏针对性。实际上,搭建一套专业且标准的 Python 开发环境不需要花费任何费用。Python 官方解释器本身完全免费开源,主流开发工具 Visual Studio Code 也是免费提供给个人和商业使用的。
本文将分别针对 Windows 和 macOS 两大主流操作系统,演示从官方下载 Python 解释器、配置关键选项,到安装免费编辑器 VS Code 并运行第一行代码的完整过程,帮助读者安全、规范地完成开发环境的搭建。
一、免费 Python 开发环境的核心构成
在开始操作之前,先理清开发环境的四个基本组件,有助于理解后续每一步的意义:
- Python 解释器(Python Runtime):负责读取并执行 Python 代码的核心引擎,由官方基金会(Python Software Foundation)免费发布。
- 包管理工具(pip):Python 官方内置的扩展包下载工具,用来免费安装来自开源社区的海量功能模块(如用于数据分析的 pandas、自动化处理的 requests 等)。
- 代码编辑器(VS Code):微软开发的免费开源编辑器,提供代码高亮、智能自动补全和调试辅助。
- 系统终端(Terminal / PowerShell):用于直接运行命令、启动程序或查看输出结果的窗口。
二、Windows 系统安装 Python 详细步骤
在 Windows 10 或 Windows 11 下安装 Python,最重要的是通过官方正规渠道下载安装包,并在安装初始界面正确勾选环境变量选项。
步骤 1:访问官网并下载安装包
打开浏览器访问 Python 官方主页 python.org。鼠标悬停在导航栏的 Downloads 上,网站会自动识别你的操作系统,并显示适用于 Windows 的最新稳定版本下载按钮(例如“Download Python 3.12.x”)。点击该按钮,下载扩展名为 .exe 的 64 位安装程序。
步骤 2:运行安装向导并勾选 PATH(关键步骤)
下载完成后,双击运行该 .exe 安装文件。此时会出现安装配置窗口,务必注意窗口底部的选项:
- 勾选 Use admin privileges when installing py.exe(如果显示该项)。
- 特别重要:必须勾选 “Add python.exe to PATH”。该选项的作用是将 Python 的执行文件路径自动写入 Windows 系统的环境变量。如果遗漏勾选,后续在 PowerShell 或命令提示符中直接输入
python时,系统将无法识别该命令。
勾选完毕后,直接点击中间的 Install Now(立即安装)。安装向导会自动复制文件并完成默认配置,耗时通常在 1 到 2 分钟内。
步骤 3:解除路径长度限制(可选)
安装结束前,向导界面若出现 “Disable path length limit”(禁用路径长度限制)的提示,建议直接点击该选项并允许管理员权限。这可以防止在后续安装深层嵌套的第三方库时出现 Windows 传统 260 字符路径超长错误。
步骤 4:验证 Windows 下的安装结果
安装完成后,按下快捷键 Win + R,在运行对话框中输入 powershell 并回车(或在开始菜单搜索“PowerShell”打开)。在窗口中输入以下测试命令:
python --version
正确配置时,控制台将输出类似以下的版本信息:
Python 3.12.3
接着输入命令验证包管理器 pip:
pip --version
如果能看到类似 pip 24.0 from ... (python 3.12) 的输出,说明 Windows 系统的 Python 基础环境已安装成功。
三、Mac 系统安装 Python 详细步骤
macOS 系统自带一套旧版 Python 或受限运行环境,开发者不应直接依赖系统内置环境进行日常开发。在 Mac 上免费安装 Python 有两种推荐途径:官方 .pkg 安装包和开源包管理器 Homebrew。对于初学者,推荐直接采用官方安装包。
步骤 1:下载并运行官方 .pkg 安装包
- 使用 Safari 或 Chrome 访问
python.org/downloads/macos/。 - 下载最新的 macOS 64-bit universal2 installer。该安装包同时支持搭载 M1/M2/M3/M4 芯片的 Apple Silicon 设备以及旧款 Intel 架构的 Mac。
- 双击打开下载好的
.pkg文件,按照屏幕提示连续点击“继续”并同意许可协议,输入 Mac 登录密码以允许写入系统,等待安装完成。
步骤 2:运行 Install Certificates(防止网络证书报错)
安装完成后,系统会自动打开一个名为 Python 3.x 的访达(Finder)文件夹。在里面可以看到一个名为 Install Certificates.command 的脚本文件:
务必执行:双击运行 Install Certificates.command 文件。此脚本会自动下载并配置 Python 需要的 SSL 根证书。如果漏掉此步,后续通过代码访问 HTTPS 网址或执行某些网络下载时,常会触发 SSL: CERTIFICATE_VERIFY_FAILED 报错。
步骤 3:在 Mac 终端中验证安装
按下快捷键 Cmd + 空格,在聚焦搜索中输入“终端”(Terminal)并回车。在打开的终端窗口中输入:
python3 --version
pip3 --version
注意指令名称:在 macOS 系统中,新安装的 Python 默认关联的命令是 python3 和 pip3,而不是单独的 python。这是因为 macOS 系统保留了 python 作为旧版兼容别名。运行带有数字 3 的命令可以确保直接调用刚刚安装的最新版本。
四、安装与配置免费编辑器:Visual Studio Code
有了 Python 解释器后,虽然可以使用系统记事本或自带的 IDLE 写代码,但为了提高学习和调试效率,强烈建议配合主流的代码编辑器。微软的 Visual Studio Code(简称 VS Code)是当前最推荐的免费代码编辑器。
1. 下载并安装 VS Code
访问官方网站 code.visualstudio.com,网站会自动识别操作系统并提供相应的安装包:
- Windows 用户:下载“User Installer 64-bit”安装程序,双击运行。在安装选项界面,建议勾选“添加到 PATH”以及“将‘通过 Code 打开’添加到上下文菜单”。
- Mac 用户:下载 Mac 对应的
.zip压缩包,解压后将Visual Studio Code.app拖入“应用程序”(Applications)文件夹中即可。
2. 安装 Python 官方扩展
- 启动 VS Code。
- 点击左侧侧边栏的扩展图标(四个方块组成的图标,或使用快捷键
Ctrl + Shift + X/ Mac 下为Cmd + Shift + X)。 - 在顶部搜索框输入
Python,找到由 Microsoft 发布的官方插件(通常排在第一位),点击 Install(安装)。该插件将自动提供代码高亮、格式化工具和调试支持。
3. 编写并运行第一行代码
- 在电脑上任意位置新建一个文件夹(例如命名为
python_demo)。 - 在 VS Code 中点击菜单 File > Open Folder(文件 > 打开文件夹),选择刚建好的文件夹。
- 在左侧资源管理器中点击“新建文件”图标,命名为
test.py。 - 在文件中输入以下测试代码:
# 第一个 Python 测试程序
message = "Python 开发环境配置成功!"
print(message)
print("Windows 和 Mac 均已就绪。")
- 点击代码编辑窗口右上角的绿色播放箭头(Run Python File)。VS Code 会在下方自动唤起集成终端并执行该脚本,输出运行结果。
五、常见问题排查与速查决策
在搭建环境的过程中,如果遇到命令不生效或下载缓慢的情况,可以对照以下决策流程进行快速排查:
常见问题 1:Windows 提示“'python' 不是内部或外部命令”
这是 Windows 初学者最常遇到的问题,其根本原因是安装时漏选了“Add python.exe to PATH”。最简单的修复办法是:
- 重新双击打开之前下载的 Python 官方
.exe安装包。 - 在出现的窗口中点击 Modify(修改)。
- 连续点击 Next,在随后的 Optional Features 列表中确保勾选 pip 和 Add Python to environment variables,最后点击 Install 完成修复。
- 关闭当前所有的终端窗口,重新打开一个新的 PowerShell 即可生效。
常见问题 2:pip 安装第三方库速度过慢或超时
pip 默认连接国外的官方 PyPI 服务器下载模块。在国内网络环境下,可以配置国内知名大学或机构维护的免费镜像源(如清华大学开源软件镜像站),大幅提升下载速率。在终端中执行以下单行命令即可永久生效:
# 配置清华大学免费开源镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
配置完成后,后续运行如 pip install requests 等模块安装命令时,系统将自动使用高速镜像源下载。
常见问题 3:VS Code 运行代码时提示找不到解释器(Select Interpreter)
在个别情况下,VS Code 未能自动检测到新装的 Python 路径,编辑窗口右下角会显示“Select Interpreter”。此时只需:
- 在 VS Code 界面中按下快捷键
Ctrl + Shift + P(Mac 下为Cmd + Shift + P)调出命令面板。 - 输入
Python: Select Interpreter并按回车。 - 列表会列出检测到的已安装 Python 版本,直接点击官方安装的那个版本条目即可建立绑定。
六、Windows 与 Mac 安装操作快速对照
为了便于查阅两套系统的差异,下表汇总了关键维度的对照总结:
| 对比维度 | Windows 系统 | macOS 系统 |
|---|---|---|
| 官方安装包格式 | .exe (64-bit installer) |
.pkg (Universal2 架构包) |
| 默认终端启动命令 | python 和 pip |
python3 和 pip3 |
| 安装核心注意事项 | 安装界面务必勾选 Add python.exe to PATH | 安装后双击运行 Install Certificates.command |
| 命令行终端工具 | Windows 终端 / PowerShell | 系统自带“终端”(Terminal) |
| 配套推荐免费编辑器 | VS Code (User Installer) | VS Code (Mac 应用程序版) |
| 总体费用 | 完全免费(开源软件) | 完全免费(开源软件) |
七、结语
安装 Python 开发环境并不需要复杂的专业配置或昂贵的商业工具。通过本文介绍的官方原厂安装包与 Visual Studio Code 编辑器,即可在 Windows 与 Mac 设备上搭建起符合规范、轻量且强大的免费工作流。环境就绪后,无论是进行自动化脚本编写、数据处理还是 Web 开发,都可以直接在此基础上平稳起步。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









