Windows和Mac怎么安装Python并配置VS Code开发环境
详细讲解在Windows和Mac系统上安装Python并配置Visual Studio Code开发环境的完整步骤,包括解释器安装、环境变量设置、插件配置、代码运行及常见问题排查。
一、理解核心分工:为什么不能只安装 VS Code?
初次接触编程时,容易产生一种认知误区:“既然 VS Code 是编写代码的软件,那只要下载安装 VS Code 就能直接写 Python 并运行”。这种说法忽略了代码编辑与代码执行的分工。
VS Code 本质上是一款轻量级的纯文本编辑器,它拥有出色的界面排版、文件管理和插件扩展能力,但其自身并不包含 Python 语言的运行引擎(即 Python 解释器)。如果电脑中没有安装 Python,VS Code 充其量只能对 .py 文件提供基础的文字展示与语法高亮,既无法真正解析语法,也无法运行脚本。
反过来,如果只安装了 Python 解释器而没有趁手的编辑器,虽然可以通过系统自带的记事本写代码并在命令行运行,或者使用自带简易的 IDLE,但编写多文件项目、调试代码或代码补全时体验较为有限。因此,规范的配置思路是由操作系统安装 Python 解释器提供底层计算支持,VS Code 负责前端开发交互,两者通过微软官方提供的 Python 插件进行桥接。
二、Windows 系统安装 Python 步骤
在 Windows 10 或 Windows 11 环境中,官方推荐直接从 Python 官方网站获取安装包。整个流程中,最关键的一步是正确勾选环境变量开关。
1. 下载官方安装包
打开浏览器访问 Python 官方网站(python.org),在顶部导航栏的 Downloads 区域点击针对 Windows 的下载按钮,获取 64 位稳定版本的可执行安装程序(.exe 格式)。
2. 运行安装程序与关键选项
双击运行下载好的安装程序,安装首页会出现两个选项与两个复选框:
- 必须勾选:“Add python.exe to PATH”:该选项位于安装界面最底部。勾选后,安装程序会自动将 Python 及其脚本路径写入 Windows 系统的环境变量 PATH 中。如果不勾选,后续在命令提示符或 PowerShell 中直接输入
python将出现“不是内部或外部命令”的提示。 - 推荐勾选:“Use admin privileges when installing py.exe”:赋予安装器管理员权限,便于系统级注册。
- 安装方式选择:如果日常使用默认账户,直接点击“Install Now”即可;若希望自定义安装路径(例如放在非系统盘或较短的路径如
C:\Python312),可点击“Customize installation”,保留所有默认可选特性后,在高级选项中勾选“Install Python for all users”并指定目标路径。
3. 解除路径长度限制(Optional)
安装完成界面如果提示“Disable path length limit”,建议点击该选项。它解除了 Windows 传统 260 字符的最大文件路径限制,有助于避免后续安装深度嵌套的第三方依赖包时产生路径过长错误。
4. 验证 Windows 安装结果
按下快捷键 Win + R,在运行窗口输入 cmd 回车打开命令提示符,执行以下验证命令:
python --version
pip --version
若终端正确返回了 Python 及其包管理工具 pip 的版本号(例如 Python 3.12.x 与 pip 24.x.x),则证明 Python 已成功安装且环境变量配置正常。
三、Mac 系统安装 Python 步骤
与 Windows 相比,Mac 系统的环境略微特殊。许多初学者会疑惑:“Mac 系统好像本来就可以运行某些 Python 脚本,还需要额外安装吗?”这里需要先辨析系统自带环境与独立开发环境的区别。
1. 辨析:Mac 自带 Python 与独立开发环境
在较早版本的 macOS 中,系统预装了 Python 2.7;而在较新的 macOS 版本(如 macOS Monterey 及之后)中,系统仅在安装 Command Line Tools 时附带有限的 Python 3 运行时供系统工具使用。
直接在系统预留环境中进行日常开发存在明显缺陷:系统路径受系统完整性保护(SIP)限制,使用 sudo pip 容易破坏操作系统自带工具的依赖关系。因此,正规做法是为开发工作单独安装一套干净、可控的 Python 解释器。
2. 安装方式:官方 PKG 与 Homebrew
Mac 上主要有两种标准的安装途径,读者可根据自身习惯任选其一:
-
方式 A(新手推荐):官方 PKG 安装包
访问 Python 官网(python.org),下载 macOS 适用的macOS 64-bit universal2 installer格式的.pkg文件。双击打开安装器,按照提示一路点击“继续”和“同意”。安装程序会自动把解释器部署到/Library/Frameworks/Python.framework/Versions/下,并在/usr/local/bin生成对应的软链接。安装完成后,还会自动弹出一个文件夹,内有“Install Certificates.command”脚本,双击运行该脚本可自动更新 SSL 根证书,避免后续 pip 下载时因证书问题报错。 -
方式 B(开发者常用):通过 Homebrew 安装
若系统已安装了 Mac 社区常用的包管理器 Homebrew,直接打开终端(Terminal)执行一条命令即可:
Homebrew 会自动处理依赖并把 Python 软链接至brew install python/opt/homebrew/bin/python3(Apple Silicon 机型)或/usr/local/bin/python3(Intel 机型)。
3. 验证 Mac 安装结果
打开 Mac 的“终端”(Terminal),执行以下检查命令。注意,在 Unix/Mac 系统上,为了区分旧版 Python 2,官方与 Homebrew 的可执行文件名默认均为 python3:
python3 --version
pip3 --version
which python3
如果终端输出了类似 Python 3.12.x,且 which python3 显示的路径指向 /Library/Frameworks/... 或 /opt/homebrew/bin/python3,说明独立开发环境已经就绪。
四、安装与配置 Visual Studio Code
当底层 Python 解释器就绪后,接下来安装并配置编写代码的核心工具 VS Code。
1. 获取并安装 VS Code
前往 VS Code 官网(code.visualstudio.com),网站会根据你的操作系统自动识别提供下载链接:
- Windows 用户:下载“User Installer(x64)”并运行。在安装选项页中,建议勾选“将‘通过 Code 打开’操作添加到 Windows 资源管理器文件上下文菜单”以及“添加到目录上下文菜单”,这样可以直接在任意文件夹上右键用 VS Code 打开。
- Mac 用户:下载得到一个
.zip压缩包,解压后得到Visual Studio Code.app,将其拖动到“应用程序”(Applications)文件夹中即可完成安装。
2. 安装 Python 核心扩展
启动 VS Code,点击左侧边栏形似四个方块拼接的“扩展”(Extensions)图标(或使用快捷键 Ctrl + Shift + X / Cmd + Shift + X)。在搜索框中输入 Python,找到由 Microsoft 官方发布、下载量数亿次的插件,点击“Install”。
安装该插件时,VS Code 会同时自动安装 Pylance(提供语法分析、类型推断与自动补全)以及 Python Debugger(提供断点调试功能),无需逐一单独寻找。
Chinese (Simplified) 安装微软官方中文语言包,安装后右下角会提示重启软件,重启后即为全中文界面。
五、创建项目并运行第一个 Python 脚本
初学者在配置好软件后,常犯的一个错误是直接点击“新建文件”写完代码就点运行,结果发现终端找不到路径。在现代开发中,规范的第一步是以文件夹作为项目工作区。
1. 打开或创建项目工作目录
在电脑中新建一个专门存放代码的文件夹(例如桌面上的 learn_python)。然后在 VS Code 菜单栏选择“文件” -> “打开文件夹”(Open Folder),选择刚才新建的文件夹。此时左侧“资源管理器”就会以该文件夹为根目录展开。
2. 新建 Python 脚本
在资源管理器空白处点击“新建文件”小图标,命名为 main.py。在编辑区域输入以下简单测试代码:
import sys
name = "World"
print(f"Hello, {name}!")
print(f"当前运行的 Python 版本是: {sys.version.split()[0]}")
print(f"解释器路径为: {sys.executable}")
3. 选择正确的 Python 解释器(Select Interpreter)
这是将 VS Code 与系统 Python 真正关联的关键一步:
- 按下快捷键
Ctrl + Shift + P(Windows)或Cmd + Shift + P(Mac)呼出命令面板。 - 在顶部输入框键入
Python: Select Interpreter并回车。 - 下拉列表中会展示 VS Code 在你系统中扫描到的所有可用 Python 解释器。选择刚才安装的官方版本(例如显示为
Python 3.12.x ('Global': ...))。
选择完成后,VS Code 窗口右下角的状态栏会常驻显示当前工作区正在使用的 Python 版本号。
4. 执行代码并查看输出
运行代码有多种方式,推荐以下两种:
- 方式一(界面快捷操作):在
main.py标签页的右上角,点击实心三角“运行”按钮(或下拉选择“Run Python File”)。VS Code 会自动在下方拉起集成终端,并自动发送执行命令。 - 方式二(终端直接执行):按下快捷键
Ctrl + `(反引号,Esc下方)唤出集成终端,Windows 用户输入python main.py,Mac 用户输入python3 main.py回车执行。
若终端清晰输出了问候语、版本号及具体的 sys.executable 安装路径,表明开发环境已经完全打通。
六、进阶隔离:为什么建议为项目创建虚拟环境(venv)?
当代码能够顺利执行后,绝大部分读者会马上开始使用 pip install 安装各种第三方开源库(例如 requests、pandas、django 等)。此时经常会遇到一个关于环境管理的进阶疑问:“为什么老开发者总是强调不要把库直接装在全局环境里?”
如果所有项目都依赖全局唯一的 Python 环境,当项目 A 需要 requests==2.25.0,而项目 B 依赖升级版 requests==2.31.0 时,全局环境就会产生依赖版本冲突。
Python 官方推荐的最佳实践是虚拟环境(Virtual Environment,内置模块 venv)。它会在项目目录下创建一个独立的文件夹,拥有自己专属的 python 可执行程序副本和 site-packages 第三方库文件夹,实现项目间互相彻底隔离。
在 VS Code 的内置终端中创建与激活虚拟环境非常简便:
# 1. 在当前项目根目录下创建名为 .venv 的虚拟环境
# Windows 执行:
python -m venv .venv
# Mac 执行:
python3 -m venv .venv
创建完成后,VS Code 通常会弹出右下角提示:“We noticed a new environment has been created. Do you want to select it for the workspace folder?”,点击 Yes,VS Code 会自动将当前项目的解释器切换至 .venv。
以后在这个终端中执行 pip install <package-name>,所有第三方库都会安全下载至当前项目的 .venv 文件夹中,丝毫不会污染全局操作系统环境。
七、常见报错与排查清单
在实际安装与配置过程中,由于各人电脑历史遗留软件不同,可能会遇到几类典型问题。遇到报错时,可依照下表针对性排查:
| 报错表现与现象 | 根本原因分析 | 具体解决方法 |
|---|---|---|
| Windows 提示:'python' 不是内部或外部命令 | 安装 Python 时未勾选“Add python.exe to PATH”,操作系统在全局搜索路径中找不到 python.exe。 |
重新运行安装包点击“Modify”,补选 PATH;或在 Windows“环境变量”中手动将 Python 安装路径及其下的 Scripts 目录追加到 Path 变量中,改完后必须彻底重启终端。 |
| Mac 提示:zsh: command not found: python | 现代 macOS 移除了默认的 python 软链接,默认命令名称为 python3。 |
改用 python3 和 pip3 执行;或在终端配置文件 ~/.zshrc 中加入 alias python=python3,保存后执行 source ~/.zshrc。 |
| Windows 打开商店:输入 python 后跳转到应用商店 | Windows 自带的“应用执行别名”(App execution aliases)劫持了 python 命令。 | 打开系统“设置” -> 搜索“应用执行别名” -> 找到并关闭两个名为“应用安装程序 (python.exe)”的开关。 |
| ModuleNotFoundError:明明 pip 安装了库,代码却报错找不着 | 终端中安装库所使用的 pip 所属解释器,与 VS Code 当前选定的 Python 解释器不是同一个。 | 按 Ctrl/Cmd + Shift + P 查看当前选定的解释器完整路径,与终端输入 which python(或 where python)的结果对比,确保两者指向同一环境。 |
八、总结与日常工作流建议
配置 Python 开发环境并非一次性的机械记忆,而是理解现代软件工程中“运行引擎”与“集成开发界面”分离的设计思想。总结起来,Windows 与 Mac 虽然在安装细节和命令命名上存在细微差异,但核心脉络完全一致:
- 下载安装官方解释器:Windows 切记勾选 PATH 环境变量;Mac 认准
python3并及时更新根证书。 - 安装配置 VS Code:安装 Microsoft 官方的 Python 插件套件,获得语法高亮、自动补全与调试支持。
- 以文件夹建立工作区:编写代码时始终通过“打开文件夹”管理工程,并通过命令面板(
Ctrl/Cmd + Shift + P)为该项目指定正确的 Python 解释器。 - 按需使用虚拟环境:通过
python -m venv .venv保持全局环境纯净,让不同项目之间的依赖库井井有条。
完成以上步骤后,你的电脑就已经建立起了一个符合现代工程规范的 Python 编程环境,可以顺畅地投入后续的语法学习、数据处理或工程开发之中。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













