怎么在Windows和Mac上正确安装Python环境

夏知夏

发布时间：2026-11-12 | 5人浏览过

原创

针对Windows与macOS双平台的完整Python环境安装实操教程。深入讲解官方安装器选择、环境变量PATH配置机制、终端命令验证、虚拟环境隔离以及常见安装故障排查，帮助初学者与开发者建立标准、干净的Python开发环境。

开发环境配置适用系统：Windows 10/11 & macOS 12+ 目标：零冲突、标准化的 Python 本地环境

在 Windows 和 macOS 上正确安装 Python 环境，关键是做好两件事：第一，确保官方解释器被正确注册到系统的环境变量（PATH）中，让终端在任何路径下都能精准识别并运行命令；第二，确立“基础环境只做解释器、项目依赖通过虚拟环境隔离”的使用规范，彻底防止因第三方包版本冲突导致的环境崩溃。按照标准流程安装，后续的开发与学习就能远离绝大多数“找不到命令”或“权限拒绝”的困扰。

怎么在Windows和Mac上正确安装Python环境 — 图 1：Python 跨平台环境安装与系统分层调用概览

一、安装前的核心认知与准备工作

很多初学者在刚接触 Python 时容易走入两个误区：一是直接在搜索引擎随意下载各种第三方“全家桶”或非官方打包安装包，导致附带冗余插件；二是在没有搞清楚操作系统机制的情况下直接覆盖系统底层文件。为了建立一个稳定且长久可用的开发环境，我们在动手前先明确几个基础原则：

必须坚持从官方源下载：统一从 Python 官方网站（python.org）获取经由核心团队维护签名的原生安装程序（CPython）。
版本选择策略：建议优先选择当前维护周期内的最新稳定版（如 Python 3.12 系列）。如果读者需要运行特定遗留项目，需以项目要求的版本为准，但均应遵循相同的环境变量配置原则。
认识终端环境：Windows 推荐使用 PowerShell 或 Windows Terminal（传统的 CMD 亦可）；macOS 推荐使用默认的 Terminal（配备 Zsh Shell）。

二、Windows 系统下的正确安装与配置步骤

Windows 系统的安装过程主要依赖官方提供的向导程序，但其中存在一个最容易被忽略的关键选项，直接决定了安装后能否在命令行顺畅使用 Python。

1. 下载 64 位官方安装器

访问官方下载页面 python.org/downloads/windows，找到对应稳定版本的 Windows installer (64-bit) 并下载到本地。除非使用的是极其罕见的 32 位老旧设备，否则务必选择 64 位版本。

2. 核心操作：勾选环境变量选项（Add python.exe to PATH）

双击启动安装程序后，首屏界面非常关键。在界面底部有两个复选框：

Use admin privileges when installing py.exe（默认勾选，保持即可）；
Add python.exe to PATH（默认未勾选，必须手动勾选！）。

如果不勾选这一项，Windows 系统的环境变量 PATH 中就不会记录 Python 解释器及其工具脚本的绝对路径。之后在 PowerShell 中键入 python 时，系统就会报出“不是内部或外部命令，也不是可运行的程序”错误，甚至会直接弹出 Windows 应用商店的推广页面。

3. 自定义配置与解除长路径限制

推荐点击“Customize installation”进入自定义组件界面，确保勾选 pip、tcl/tk and IDLE 以及 Python test suite。进入“Advanced Options”后，可以勾选 Install Python for all users（如果需要在整机通用）或使用默认用户目录。

安装进度完成后，最后一步如果界面出现 “Disable path length limit” 按钮，务必点击它并允许管理员授权。由于 Windows 历史上存在 260 字符的文件路径长度上限，深度嵌套的 Python 依赖包在安装时可能会因此报错，点击该按钮可解除此限制。

4. Windows 环境验证

安装完成后，必须关闭之前已打开的所有命令行窗口，重新打开一个新的 PowerShell 窗口进行验证。执行以下命令：

# 1. 验证 Python 解释器版本与路径
python --version
示例输出: Python 3.12.3

# 2. 验证包管理器 pip
pip --version
示例输出: pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)

# 3. 检查系统定位到的真实程序路径
where python
示例输出: C:\Users\Username\AppData\Local\Programs\Python\Python312\python.exe

排错提示：输入 python 为什么自动弹出了微软应用商店？

这是 Windows 10/11 系统的常见问题。打开 Windows“设置” → 进入“应用” → 点击“高级应用设置”中的“应用执行别名”，在列表中找到名为“python.exe”和“python3.exe”的应用安装程序开关，将其全部关闭。随后系统就会优先使用我们刚刚手动安装的官方 Python。

三、macOS 系统下的正确安装与配置步骤

macOS 的环境与 Windows 有显著区别。很多初学者在 Mac 终端中输入 python3 时发现已经有输出，便以为自己不需要安装，或者试图直接覆盖系统自带环境，这往往是后续混乱的根源。

1. 理解 macOS 自带 Python 的边界

macOS 系统在 /usr/bin/python3 预置了与系统底层工具或 Xcode 命令行工具相关的 Python 解释器。请务必牢记：绝不要尝试使用管理员权限（sudo）去修改、替换或在此环境下直接安装第三方包。该解释器由苹果系统完整性保护（SIP）锁定，是系统自身的依赖，开发者应当安装完全独立的专用解释器。

2. 安装方式：官方安装包（pkg）与 Homebrew

在 Mac 上有两种主流且完全规范的安装方式：

方式一：官网 pkg 安装包（推荐初学者使用）：访问 python.org/downloads/macos，下载 macOS 64-bit universal2 installer。安装包会自动完成解包、将解释器部署到 /Library/Frameworks/Python.framework，并在 /usr/local/bin 下建立正确的软链接。安装完成后，还会弹出访达窗口，双击运行其中的“Install Certificates.command”，完成 SSL 根证书证书库的初始配置。
方式二：通过 Homebrew 安装（适合习惯包管理的开发者）：如果你的 Mac 已经配置了 Homebrew，只需在终端中执行 brew install python，系统会自动解析依赖并完成软链接。在 Apple Silicon 芯片（M1/M2/M3 等）上，解释器将被置于 /opt/homebrew/bin/python3。

3. 配置并确认终端 PATH 优先级

macOS 默认使用 Zsh 作为 Shell。为了确保我们在终端中键入 python3 时优先调用刚安装的用户解释器，我们需要检查环境变量。打开终端，查看当前 PATH：

echo $PATH
示例输出: /opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

只要 /usr/local/bin 或 /opt/homebrew/bin 排在 /usr/bin 之前，系统就会优先使用用户自装的 Python，而不是系统的保护版本。如果需要显式固化环境变量，可以编辑用户主目录下的配置文件：

# 编辑 ~/.zshrc 或 ~/.zprofile 文件
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. macOS 环境验证

在终端输入以下命令确认：

# 1. 验证用户解释器（注意 Mac 终端需使用 python3 命令）
python3 --version
示例输出: Python 3.12.3

# 2. 查看真实调用的可执行文件路径
which python3
示例输出: /Library/Frameworks/Python.framework/Versions/3.12/bin/python3
# （若为 Apple Silicon 的 Homebrew，则为 /opt/homebrew/bin/python3）

# 3. 验证 pip3
pip3 --version

四、进阶规范：使用虚拟环境（venv）管理项目依赖

安装完 Python 并不意味着可以直接在全局无脑执行 pip install。无论是 Windows 还是 Mac，直接把所有库安装到全局基础环境都是极坏的习惯：随着学习的深入，不同项目所依赖的库版本可能相互冲突；更重要的是，Python 3.12 之后严格落实了 PEP 668 规范，直接全局 pip 安装时会直接抛出 externally-managed-environment 错误并阻止执行。

正确的现代 Python 开发姿势是：每一个独立项目，都拥有一个属于自己的虚拟环境。

1. 创建虚拟环境的具体操作流程

Python 内部自带了 venv 模块，无需额外安装第三方工具。操作步骤如下：

# 第一步：新建并进入你的专属工程目录
mkdir my_project && cd my_project

# 第二步：在项目根目录下生成名为 .venv 的虚拟环境目录
# Windows:
python -m venv .venv
# macOS:
python3 -m venv .venv

# 第三步：激活虚拟环境
# Windows PowerShell 下执行:
.venv\Scripts\Activate.ps1
# （若为 Windows CMD，则执行: .venv\Scripts\activate.bat）
# macOS 终端下执行:
source .venv/bin/activate

激活成功后，你的命令行提示符最前面会出现 (.venv) 字样。此时再执行 pip install <package_name>，所有安装的第三方包都会被严格存放在当前项目的 .venv 文件夹中，绝对不会影响系统的其他项目或全局环境。

当工作完成需要退出虚拟环境时，只需在终端中简单输入 deactivate 即可。

Windows 提示“在此系统上禁止运行脚本”的处理方法

如果在 Windows PowerShell 中执行 Activate.ps1 时出现脚本执行策略报错，这是因为系统默认 ExecutionPolicy 较为保守。以管理员身份打开 PowerShell，输入 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 并回车确认，即可正常激活虚拟环境。

五、常见安装故障排查与诊断决策矩阵

在实际部署过程中，如果遇到与预期不一致的表现，请对照下表中的诊断决策矩阵逐项排查：

平台	异常现象	诱发根因	标准修复方案
Windows	输入 `python` 无法识别为命令	安装时漏选 `Add python.exe to PATH`	重新运行安装包，在界面选择 Modify，补勾 PATH 选项并重新启动终端。
Windows	命令提示符下总是跳转微软商店	Windows 预置的应用执行别名优先级高于本地程序	在系统设置中关闭“应用执行别名”里的 Python 项。
macOS	执行 `pip3 install` 提示外部管理环境报错	PEP 668 保护全局环境免受破坏	建立局部项目虚拟环境（`python3 -m venv .venv`），在激活状态下安装。
双平台	电脑上装了多个版本，无法指定特定版本	环境变量中默认只暴露排在最前的版本	Windows 可使用启动器 `py -3.11 main.py`；Mac 直接使用对应别名 `python3.11 main.py`。

六、安装后的最佳实践清单

完成上述配置后，你的计算机上已经拥有了一个标准且健壮的 Python 运行底座。为了保持环境的长期清爽与可维护性，建议在日常开发中遵守以下习惯：

保持基础解释器干净：全局环境只负责提供基础运行支持，业务代码运行一律进入对应虚拟环境。
使用 requirements.txt 固化依赖：在虚拟环境中，经常通过 pip freeze > requirements.txt 记录当前项目的依赖版本，便于在其他设备或协同开发时一键重现环境（pip install -r requirements.txt）。
配置国内可信镜像源（可选加速）：如果遇到 pip 下载网络波动，可通过命令 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 配置国内清华大学或阿里云等官方镜像加速。

只要理顺了“安装器 — PATH 环境变量 — 终端命令分发 — 项目级虚拟环境”这一完整链路，无论是继续学习数据处理、Web 开发还是自动化脚本，环境问题都将不再成为阻碍。