零基础学Python：Windows与Mac系统安装及环境配置指南

小林子

发布时间：2026-11-14 | 7人浏览过

原创

面向零基础学习者的Python安装与环境配置指南，涵盖Windows与macOS双系统的官方安装包获取、环境变量PATH设置、终端验证、pip换源以及虚拟环境隔离等核心操作。

学习 Python 的第一步并非编写复杂算法，而是在计算机中正确安装解释器并建立稳定的运行环境。本文提供 Windows 与 macOS 两个主流操作系统的官方安装路径、环境变量配置方法、命令行可用性验证，以及虚拟环境管理方案，帮助初学者跨越安装初期的各类常见阻碍。

零基础学Python：Windows与Mac系统安装及环境配置指南 — 图 1：Windows 与 macOS 双平台下的安装形式与核心环境特征对比

一、Windows 系统下的安装与环境变量配置

Windows 系统的安装难点主要集中在安装向导初始页面的选项勾选，以及环境变量 PATH 的有效生效机制。通过官方提供的安装包，遵循标准流程即可一次配置成功。

1. 获取官方安装包

打开浏览器访问 Python 官方网站（python.org），在顶部导航栏找到 Downloads，点击 Windows。在稳定发布版本（Stable Releases）列表中，根据系统架构选择下载“Windows installer (64-bit)”。建议初学者选择最新的稳定维护版本（例如 Python 3.12 系列或 3.11 系列），避免下载标有 pre-release 或 RC 字样的测试版本。

2. 执行安装与关键选项

双击打开下载的 python-3.x.x-amd64.exe 安装程序。安装向导的第一屏至关重要：

必须勾选底部复选框： Add python.exe to PATH。此项的作用是将 Python 解释器及 Scripts 目录自动追加到 Windows 用户环境变量 PATH 中。若漏选此项，在命令提示符中输入 python 将无法识别。
选择 Customize installation（自定义安装）或 Install Now（立即安装）。若系统盘空间充足且无特殊要求，可直接点击 Install Now。若希望指定简洁安装路径（如 C:\Python312），点击 Customize installation，保留所有可选组件（Documentation、pip、tcl/tk、IDLE、Python test suite），并在随后的高级选项中勾选 Install Python for all users 并设置目标路径。
安装结束页面若出现 Disable path length limit（解除路径长度限制），建议点击该项并允许管理员权限，以避免后续第三方库因文件路径超过 260 字符而产生异常。

3. Windows 环境变量手动补充（仅漏选时执行）

如果在安装时漏选了 Add python.exe to PATH，打开 PowerShell 输入 python 会提示 'python' 不是内部或外部命令，也不是可运行的程序。此时无需重新安装，可手动补全：

按下快捷键 Win + S 搜索并打开“编辑系统环境变量”。
在“系统属性”窗口中点击右下角“环境变量”按钮。
在“用户变量”区域找到 Path，双击打开编辑界面。
点击“新建”，输入 Python 根目录（例如 C:\Users\用户名\AppData\Local\Programs\Python\Python312）。
再次点击“新建”，输入配套的 Scripts 目录（例如 C:\Users\用户名\AppData\Local\Programs\Python\Python312\Scripts）。
点击“确定”保存所有窗口，并重启打开新的命令提示符窗口使变量生效。

二、macOS 系统下的安装与终端环境配置

macOS 系统自带一套用于系统底层运维的 Python 运行环境或 Xcode 命令行工具附带环境。初学者切勿直接在系统目录中进行修改或通过 sudo 覆盖，而应通过官方独立的安装包安装属于用户空间的 Python 3 环境。

1. 获取并安装官方 PKG 包

在 Python 官网 Downloads 菜单下的 macOS 分类中，下载 macOS 64-bit universal2 installer。该通用安装包能够同时原生支持 Apple Silicon 架构（M1/M2/M3/M4 系列芯片）与传统 Intel 芯片架构。

下载完成后双击 python-3.x.x-macos11.pkg，根据向导提示连续点击“继续”、“同意许可”，直至安装完成。安装程序会将 Python 放置在 /Library/Frameworks/Python.framework/Versions/3.x/，同时在 /usr/local/bin 自动创建指向该版本的符号链接。

2. 运行 SSL 根证书初始化脚本

这是 macOS 官方安装包特有的必要操作。安装完成后，系统会自动打开“访达”中的 Python 程序文件夹。请双击运行其中的 Install Certificates.command 文件。

为何必须运行证书脚本？ macOS 官方发布的 Python 独立安装包自带专属的 OpenSSL 库，默认不继承操作系统的根证书钥匙串。如果不双击运行该脚本补充根证书，后续使用 urllib 抓取网页或使用某些网络库时，会直接抛出 CERTIFICATE_VERIFY_FAILED 错误。

3. macOS 下的调用指令区分

现代 macOS 已经彻底移除了系统内置的旧版 Python 2。在 macOS 终端中：

直接输入 python，通常会触发系统提示“xcode-select: note: no developer tools were found”或“command not found”。
正确调用命令是使用携带版本后缀的 python3 和 pip3。

三、命令行验证与快速执行测试

完成上述安装后，请打开系统自带的终端（Windows 下搜索打开 PowerShell 或 CMD；Mac 下打开 Terminal / 终端），分别执行以下验证命令。

验证目标	Windows 执行命令	macOS 执行命令	正确预期输出示例
检查解释器版本	`python --version`	`python3 --version`	`Python 3.12.3`
检查包管理器	`pip --version`	`pip3 --version`	`pip 24.0 from ... (python 3.12)`
检查执行文件绝对路径	`where python`	`which python3`	返回具体可执行文件的绝对路径字符串

接下来进行代码执行测试。在终端中输入 python（或 Mac 上的 python3）并按下回车，终端提示符将变为 >>>，表示已进入 Python 交互式命令行环境。输入以下测试语句：

>>> print("Hello, Python World!")
Hello, Python World!
>>> 1 + 2 * 3
7
>>> exit()

看到终端正确打印出计算结果与字符串，并顺利执行 exit() 退出交互环境，即证明基础解释器已经工作正常。

四、包管理器 pip 配置与国内源加速

Python 拥有庞大的第三方库生态，这些库都通过 pip 工具从 Python 官方包索引库（PyPI）拉取。由于 PyPI 官方服务器位于海外，国内直接下载可能面临连接超时或传输速度缓慢的问题。配置国内镜像源可以大幅提升第三方库安装体验。

1. 临时指定镜像源安装

在安装具体模块时，通过 -i 参数指定可信镜像源：

# Windows 环境示例
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

# macOS 环境示例
pip3 install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 全局永久配置镜像源

无需手动建立配置文件，通过 pip 内置的 config 指令即可自动生成全局加速配置：

# 执行全局设置（Windows 或 macOS 终端均通用）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 验证配置是否生效
pip config list

该命令会自动在 Windows 的 %APPDATA%\pip\pip.ini 或 macOS 的 ~/.config/pip/pip.conf 中写入清华大学 TUNA 镜像源配置，后续所有 pip install 指令都会自动通过国内高速节点下载。

五、使用 venv 建立独立项目虚拟环境

许多初学者在安装好环境后，习惯将所有需要的第三方库全部直接 pip install 到全局环境中。随着学习的深入，不同项目对依赖包的版本需求往往发生冲突（例如项目 A 依赖特定旧版本，项目 B 依赖最新版本）。

Python 3 内置了 venv 模块，允许为每一个独立项目单独开辟一个互不干扰的虚拟环境沙盒。规范的工作流应当如下：

虚拟环境操作标准步骤

创建项目目录并进入：
```
mkdir my_project
cd my_project
```

创建名为 .venv 的虚拟环境：

# Windows 下执行
python -m venv .venv

# macOS 下执行
python3 -m venv .venv

激活虚拟环境：
激活后，命令行提示符前方会出现 (.venv) 标记，表示当前所有的 python 和 pip 操作均被限定在此目录中。
```
# Windows (CMD 或 PowerShell)
.venv\Scripts\activate

# macOS (Terminal / zsh)
source .venv/bin/activate
```
注意：Windows PowerShell 首次激活脚本时若提示“因为在此系统上禁止运行脚本”，需以管理员身份运行 PowerShell 并执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 解除限制。
退出虚拟环境：
当项目开发完成或需要切换到其他项目时，直接在终端输入：
```
deactivate
```

六、常见安装与运行疑难排查

问题 1：Windows 下输入 python 自动跳转到微软商店（Microsoft Store）
原因： Windows 10/11 默认在用户 PATH 中加入了应用商店的应用执行别名（App Execution Aliases）。
解决方法： 打开系统“设置” > “应用” > “高级应用设置” > “应用执行别名”，将列表中与 python.exe 和 python3.exe 相关的开关全部关闭。
问题 2：macOS 运行 pip3 提示“error: externally-managed-environment”
原因： 遵循 PEP 668 规范的最新 Python 版本为保护系统全局环境免遭污染，默认禁止在全局直接运行 pip install。
解决方法： 推荐严格按照前文步骤创建并激活 venv 虚拟环境后再使用 pip install；若确实仅用于个人临时测试单文件，可加上参数 pip3 install --break-system-packages 库名。
问题 3：安装后执行命令提示版本与预期不符（旧版本残留）
原因： 系统中之前安装过 Anaconda、开发工具捆绑的 Python，或者旧版本排在 PATH 变量更前的位置。
解决方法： 执行 where python（Windows）或 which -a python3（macOS）排查列出的全部路径。在环境变量设置中，将最新安装的 Python 目录上移至最顶部。

七、总结

搭建 Python 开发环境的核心原则可以概括为三点：安装官方纯净版本、确保环境变量 PATH 正确注入、坚持通过虚拟环境进行依赖隔离。Windows 用户重点关注安装包首页的 Add python.exe to PATH 开关与长路径限制解除；macOS 用户注意通过 Install Certificates.command 完成根证书修复，并统一使用 python3 识别指令。完成这一套基础配置后，即可在稳定的本地运行环境中开始后续的 Python 学习与项目实践。