Windows/Mac安装Python及配置VS Code开发环境教程

搭建 Python 开发环境的核心任务只有两项：一是让操作系统具备运行 Python 代码的能力（安装解释器并建立路径识别），二是让代码编辑器能够定位并调用这个解释器。本教程将直接分步演示在 Windows 与 macOS 系统中安装 Python、配置 Visual Studio Code（VS Code）并完成第一个脚本运行的完整流程，同时解析新手容易混淆的环境变量与虚拟环境概念。

一、操作系统安装 Python 解释器

在安装 VS Code 之前，需要先在操作系统中安装 Python 官方解释器。不同操作系统在路径管理和默认机制上存在差异，请按照自己正在使用的系统执行相应操作。

1. Windows 系统安装步骤

访问 Python 官方网站（python.org），在 Downloads 菜单中选择 Windows，下载标有 Windows installer (64-bit) 的最新稳定版安装包。

双击打开安装包，安装向导第一页包含至关重要的选项设置：

• 勾选「Add python.exe to PATH」：请务必勾选界面底部的这一项。它的作用是将 Python 执行路径注册到 Windows 的全局环境变量中，避免后续命令行出现“不是内部或外部命令”的提示。
• 选择安装方式：推荐点击「Customize installation」检查可选特性全部勾选，随后在下一步勾选「Install Python for all users」（如果具备管理员权限），或直接使用「Install Now」。

安装完成后，若最后界面出现「Disable path length limit」，建议点击该选项以解除 Windows 默认的 260 字符路径限制。

2. macOS 系统安装步骤

macOS 系统通常自带用于系统基础支持的命令行工具，但这并非完整的独立开发环境。建议通过以下两种常见方式之一安装独立解释器：

• 官方安装包方式：访问 python.org 下载 macOS 版本的 macOS 64-bit universal2 installer，一路点击“继续”完成安装。安装结束后，在弹出的“Python 3.x”文件夹中双击运行 Install Certificates.command，该脚本用于配置 Python 发起 HTTPS 网络请求所需的 SSL 证书链。
• Homebrew 方式：如果已安装 Homebrew 包管理器，可直接在终端执行 brew install python 完成安装。

3. 验证解释器安装

打开系统的命令行终端（Windows 打开 PowerShell 或 CMD，macOS 打开“终端 Terminal”），输入以下命令检查版本输出：

# Windows 终端
python --version

# macOS 终端（macOS 将 Python 3 命名为 python3 以防冲突）
python3 --version

终端正确输出版本号（如 Python 3.12.x）即说明解释器已在操作系统层面就绪。

二、安装与配置 VS Code

访问 VS Code 官方网站（code.visualstudio.com），根据你的操作系统下载对应的安装程序：Windows 选择 User Installer，macOS 选择 Universal 或 Apple Silicon 版本。安装过程保持默认选项即可。

1. 安装核心扩展组件

点击 VS Code 左侧活动栏的方块图标（Extensions，或快捷键 Ctrl+Shift+X / Cmd+Shift+X），在搜索框输入 Python。选择由 Microsoft 官方发布的扩展包，点击「Install」。该扩展会自动联同安装 Pylance 等语言分析插件，提供代码诊断与智能补全支持。

2. 打开项目目录并关联解释器

VS Code 的工作逻辑建立在“文件夹（Folder）”之上。在日常编码中，不建议直接单独打开单个 .py 文件。

1. 在顶部菜单选择「文件 (File)」->「打开文件夹 (Open Folder)」，在电脑本地选择或新建一个空目录作为工作空间。
2. 按快捷键 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（macOS）打开命令面板。
3. 输入 Python: Select Interpreter 并回车。
4. 列表会扫描出当前系统中安装的所有 Python 路径。选择带有推荐标识（Recommended）或在第一部分安装好的 Python 路径。选择完成后，VS Code 右下角状态栏会显示已绑定的版本信息。

三、运行第一段 Python 代码

在左侧资源管理器中，点击新建文件按钮，命名为 main.py。输入以下用于检验运行与环境路径的完整代码：

import sys
import platform

print("=== 环境初始化验证 ===")
print("操作系统类型:", platform.system(), platform.release())
print("当前解释器路径:", sys.executable)
print("Python 版本号:", sys.version.split()[0])
print("运行状态: 正常")

点击编辑器右上角代表运行的三角形图标（Run Python File）。编辑器底部会自动拉起内置终端，并执行该脚本。

在内置终端中，读者应该能看到类似如下的输出内容（以下为输出示例）：

=== 环境初始化验证 ===
操作系统类型: Windows 10
当前解释器路径: C:\Users\Username\AppData\Local\Programs\Python\Python312\python.exe
Python 版本号: 3.12.2
运行状态: 正常

四、标准项目实践：建立虚拟环境 (venv)

在实际开发中，直接将所有第三方模块（使用 pip install）安装到全局环境会导致不同项目之间产生版本依赖冲突。Python 官方内置了 venv 模块，推荐为每个项目创建独立的运行沙盒。

1. 创建项目专属环境

在 VS Code 的内置终端中，确保终端路径位于当前项目根目录下，执行下列命令：

# Windows 环境下创建名为 .venv 的虚拟环境
python -m venv .venv

# macOS 环境下
python3 -m venv .venv

此时项目左侧目录中会生成一个名为 .venv 的文件夹。VS Code 会弹窗提示：“检测到新虚拟环境，是否将其选为工作区解释器？”点击「是 (Yes)」即可。

2. 验证虚拟环境处于激活状态

在 VS Code 中新建一个终端窗口（快捷键 Ctrl+Shift+`），终端命令行前端如果出现了括号包裹的 (.venv) 前缀，说明虚拟环境已成功激活。此时通过 pip 安装的任何软件包，都将只保存在项目目录下的 .venv/lib 文件夹内，不会对系统全局环境造成干扰。

五、常见问题排查与解决路径

在配置过程中，环境差异往往会导致部分步骤受阻，以下是两个高频出现的核心问题及其修复方法：

1. Windows PowerShell 提示“禁止运行脚本”

表现：在终端尝试手动激活环境（如执行 .venv\Scripts\Activate.ps1）时，提示 UnauthorizedAccess 或“因为在此系统上禁止运行脚本”。

原因：Windows 系统对 PowerShell 默认启用了保守的脚本执行策略（Restricted）。

解决方法：以管理员身份打开 PowerShell，输入命令 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，并根据提示输入 Y 确认。这允许本地创建的脚本直接执行，同时保证从外部网络下载的无签名脚本受到拦截限制。

2. macOS 提示“command not found: python”

表现：在 macOS 终端输入 python 时提示找不到命令。

原因：现代 macOS 移除了原先默认附带的 Python 2，官方安装包将程序名显式定义为 python3 和 pip3，以避免兼容性冲突。

解决方法：在终端中统一使用 python3 和 pip3。如果希望输入 python 直接调用 Python 3，可在终端配置文件（~/.zshrc）中增加别名设置：alias python=python3，保存后执行 source ~/.zshrc 即可生效。

六、总结

搭建 Python 与 VS Code 开发环境的关键，在于理解“编辑器”与“解释器”的协同关系。只要确保操作系统能正确识别 Python 安装路径、在 VS Code 中正确指明解释器，并养成通过项目文件夹与虚拟环境组织代码的习惯，就能避开绝大部分因路径冲突和版本不匹配导致的开发环境问题。