Windows与Mac下Python安装及IDE配置详细教程

双平台 Python 与开发环境全景示意图

本文面向初次在 Windows 或 macOS 系统上配置 Python 开发环境的读者，完整梳理从官方解释器安装、系统环境变量（PATH）配置与检验，到主流现代代码编辑器 VS Code（含虚拟环境隔离）的完整落地流程，帮助你在两套操作系统下建立干净、规范且可直接编写并运行代码的 Python 开发环境。

一、Python 运行体系与环境准备机制

在安装软件之前，需要先建立清晰的认知：我们通常所说的“安装 Python”，本质上是在操作系统中部署一套 CPython 解释器 以及附带的 标准库与包管理器 pip。解释器是一个可执行文件（在 Windows 下是 python.exe，在 macOS 下是 python3），它的作用是读取纯文本格式的 Python 代码并将其翻译为计算机能理解的指令执行。

而在日常使用中，我们在命令行输入 python 时，操作系统并不能凭空猜到这个程序安装在哪个文件夹。这就是 环境变量 PATH 发挥作用的地方。PATH 是系统内部维护的一个有序目录列表。每当我们在终端敲入一个指令，系统就会从这串目录里逐个搜索同名可执行文件，一旦在某个目录中命中，就立即启动它。如果翻遍所有目录都找不到，终端就会报出“不是内部或外部命令”或“command not found”。

图 1：Python 运行体系与操作系统环境分层架构

二、Windows 平台：Python 官方安装与验证

Windows 系统对 Python 解释器的管理主要依赖安装包自动写入的注册表与用户环境变量。以下是标准化安装步骤：

1. 下载官方安装包

打开浏览器访问 Python 官方网站的下载页面（https://www.python.org/downloads/windows/）。页面会自动识别当前操作系统，点击醒目的 Download Python 3.x.x 按钮，或者在下方列表中下载 Windows installer (64-bit)。对于现代 64 位 Windows 10 与 Windows 11，始终优先选择 64 位版本。

2. 执行安装与关键选项配置

双击运行下载好的 .exe 安装程序。在弹出的第一个界面中，存在一个极其关键但默认可能未勾选的选项：

• 勾选界面底部的 “Add python.exe to PATH”：这是整个安装过程中最重要的一步。勾选后，安装程序会自动把 Python 的安装目录以及存放第三方命令行工具的 Scripts 目录追加到系统的用户 PATH 环境变量中，省去后续繁琐的手工配置。
• 选择 “Customize installation”（自定义安装）：点击进入自定义设置页面。保留全部可选功能（Documentation、pip、tcl/tk 和 IDLE、Python test suite、py launcher），然后点击 Next。
• 高级选项设置：勾选 “Install Python 3.x for all users”（建议），安装路径会变为简短规范的目录（例如 C:\Program Files\Python312 或指定的 C:\Python312），避免深层用户目录中的中文或空格路径引发潜在异常。

3. 解除路径长度限制 (Disable path length limit)

当安装进度条走完，进入 “Setup was successful” 结束界面时，如果页面下方出现了 “Disable path length limit” 按钮，请务必点击它并允许管理员权限。Windows 历史上保留了 260 个字符的传统路径长度限制（MAX_PATH），点击该选项可解除此限制，防止后续在安装依赖层级较深的第三方库时因路径过长而报错。

图 2：Windows 与 macOS 双平台安装及配置步骤全景对照

4. 命令行环境验证

按下键盘快捷键 Win + R，输入 powershell 或 cmd，按回车打开命令行终端。注意：必须是在完成安装之后新打开的终端窗口，如果在安装前终端就已经处于打开状态，它将无法读取更新后的 PATH 环境变量。

python --version
pip --version

Python 3.12.8
pip 24.3.1 from C:\Python312\Lib\site-packages\pip (python 3.12)

三、macOS 平台：Python 安装与路径配置

macOS 系统的底层基于 Unix，自 macOS Catalina 起默认终端 Shell 为 zsh。在 macOS 上安装 Python 有两种推荐路径：官方 .pkg 安装包与 Homebrew 包管理器。对于新手，官方 .pkg 是最直观且独立性最佳的方案。

方式一：官方 .pkg 安装包（推荐）

1. 访问 Python 官方下载页面（https://www.python.org/downloads/macos/），下载 macOS 64-bit universal2 installer。该通用安装包能够原生运行在 Apple Silicon 芯片（M1/M2/M3/M4 系列）和 Intel 芯片的 Mac 电脑上。
2. 双击下载的 .pkg 文件，按照屏幕提示连续点击“继续”并同意许可协议，输入 Mac 开机密码完成安装。
3. 安装完成后，Python 会被部署在 /Library/Frameworks/Python.framework/Versions/3.x/ 目录下，同时安装程序会自动在 /usr/local/bin 目录下创建指向该版本的软链接。
4. 执行证书更新脚本（核心要点）：打开访达（Finder），进入“应用程序”目录下的 Python 3.x 文件夹，找到名为 Install Certificates.command 的文件，双击运行它。此脚本会自动下载并安装最新的 certifi 根证书。若跳过这一步，后续使用 pip 下载包或编写网络爬虫时，极易遭遇 SSL: CERTIFICATE_VERIFY_FAILED 握手校验错误。

方式二：使用 Homebrew 安装

若系统中已经配置好了 Mac 社区流行的包管理器 Homebrew，可直接在“终端”（Terminal）中运行一行命令完成安装：

brew install python

Homebrew 会自动将解释器安装到 /opt/homebrew/bin/python3（Apple Silicon 机型）或 /usr/local/bin/python3（Intel 机型），并妥善处理依赖关系与证书链。

macOS 命令行环境验证

打开“终端”应用（可以通过按 Cmd + 空格 输入“终端”调出），输入以下命令检查执行状态：

python3 --version
pip3 --version
which python3

Python 3.12.8
pip 24.3.1 from /Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/site-packages/pip (python 3.12)
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3

注意：在 macOS 下，请统一使用 python3 和 pip3 命令进行调用。系统严格区分了历史遗留的 python 与现代的 python3。只要 which python3 输出的路径指向 /Library/... 或 /opt/homebrew/...，而不是 /usr/bin/python3，就说明用户安装的 Python 已经稳妥接管了命令行。

四、现代 IDE 选型与 VS Code 深度配置

虽然 Python 安装自带了一个名为 IDLE 的简易编辑器，但它缺乏现代工程所需的自动补全、项目树管理、版本控制集成和图形化断点调试功能。目前业界最主流的开发工具包括轻量多功能的 Visual Studio Code (VS Code) 与专业全功能的 PyCharm。本教程以通用性极强且完全开源免费的 VS Code 为例，带你完成从零到一的工程化配置。

图 3：VS Code IDE 与虚拟环境 (venv) 配置工作流

1. 安装 VS Code 与 Python 扩展插件

访问 VS Code 官网（https://code.visualstudio.com/），下载对应操作系统的安装包并安装。启动 VS Code 后，点击左侧边栏的方块图标“Extensions”（或按快捷键 Ctrl + Shift + X，Mac 用户按 Cmd + Shift + X）。在搜索框中键入 Python，找到由 Microsoft 官方发布、拥有数千万下载量的插件，点击 Install。安装此插件时，VS Code 会自动附带安装语言分析核心组件 Pylance，提供精准的代码高亮、参数提示和跳转定义能力。

2. 建立项目文件夹与虚拟环境 (venv)

工程化开发的第一步永远是“以文件夹形式管理代码”。在你的电脑磁盘中建立一个英文名称的空文件夹（例如 py_demo）。在 VS Code 菜单中点击 File → Open Folder... 打开该目录。

接下来，按快捷键 Ctrl + `（反引号，位于 Esc 键下方）打开 VS Code 的集成终端。在终端中执行以下命令创建当前项目的独立虚拟环境：

python -m venv .venv

python3 -m venv .venv

执行后，左侧资源管理器中会出现一个名为 .venv 的新目录。这个文件夹包含了一份独立的 Python 解释器二进制副本以及专属的 Lib/site-packages 目录。

3. 在 VS Code 中绑定解释器 (Select Interpreter)

VS Code 通常能自动感知到新生成的 .venv 目录并弹出通知询问是否将其设为工作区解释器。如果未弹出，可进行手动选择：

• 按快捷键 Ctrl + Shift + P（Mac 上为 Cmd + Shift + P）调出命令面板。
• 输入 Python: Select Interpreter 并按回车。
• 在列表中选择带有 ('.venv': venv) 标记的解释器路径。

绑定完成后，观察 VS Code 界面右下角的状态栏，会清晰显示类似 Python 3.12.x ('.venv': venv) 的标识。这代表当前编辑器内的代码补全、语法检查以及执行均已与该虚拟环境紧密连接。

4. 编写并运行第一段测试代码

在左侧资源管理器中新建一个文件，命名为 main.py，输入以下用于自检环境的完整测试代码：

# -*- coding: utf-8 -*-
import sys
import platform

def main():
    print("=" * 48)
    print("Python 开发环境配置成功！")
    print(f"操作系统: {platform.system()} {platform.release()}")
    print(f"Python 版本: {sys.version.split()[0]}")
    print(f"当前生效的解释器路径:")
    print(f"  {sys.executable}")
    print("=" * 48)

if __name__ == "__main__":
    main()

运行该程序有两种便捷方式：

• 方式 A：点击编辑器右上角的“三角形播放图标”（Run Python File in Terminal）。
• 方式 B：按快捷键 F5，选择“Python Debugger: Python File”启动交互式断点调试。

================================================
Python 开发环境配置成功！
操作系统: Windows 10
Python 版本: 3.12.8
当前生效的解释器路径:
  D:\Workspace\py_demo\.venv\Scripts\python.exe
================================================

看到输出中的解释器路径包含 .venv 字段，即证明你的 Python 运行环境与 IDE 配置已经形成闭环。

五、自检清单与常见故障排查

为了帮助大家在遇到环境异常时能够迅速定位病灶，下表与决策图整理了最常见的几类问题与对应的修正方案。

图 4：Python 开发环境自检与常见故障排查决策图