VS Code 首次运行 Python 代码：安装扩展与选择解释器

当你第一次打开 VS Code 准备运行 Python 代码时，最容易遇到的困惑往往是：明明写好了代码，点击运行却毫无反应，或者弹出“未选择解释器”的提示。要顺利运行 Python 程序，核心只有两件事：第一，在 VS Code 中安装官方 Python 扩展，为编辑器注入语法识别与执行调度能力；第二，告诉 VS Code 使用电脑里安装的哪一个 Python 解释器（Interpreter）。理顺这两点，整个运行链路就会清晰顺畅。

一、理解代码运行的核心协作机制

很多初学者常把 VS Code 误认为是自带运行环境的集成软件。实际上，VS Code 本身是一个轻量级的通用代码编辑器，它自身不包含任何编程语言的编译器或解释器。它就像一个精巧的驾驶舱，而 Python 解释器才是驱动代码执行的发动机。

当你点击运行按钮时，编辑器并不会直接“理解”你的代码，而是通过扩展工具将文件路径传递给后台指定的解释器程序，再由解释器在系统终端中逐行执行并回传打印结果。如果在编辑器中没有安装配套扩展，或者没有指定解释器的准确路径，这套协作流程就无法连通。

二、准备工作：确认计算机已安装 Python 解释器

在配置 VS Code 之前，首先必须确保操作系统中已经安装了 Python。如果你的电脑尚未安装 Python，VS Code 就无法找到可调用的解释器程序。

你可以通过系统终端进行快速检验。打开系统的命令行工具（Windows 下可打开命令提示符或 PowerShell，macOS 下可打开终端应用），输入以下检测命令并按下回车：

python --version
# 若无输出或提示未找到命令，可尝试输入：
python3 --version

如果终端返回了类似 Python 3.11.8 的版本编号，说明当前系统已存在可用的 Python 解释器；若终端提示“无法识别为内部或外部命令”或“command not found”，则表明系统尚未安装 Python 或尚未将 Python 安装路径添加到系统环境变量（PATH）中，需要先完成 Python 的安装再继续后续配置。

三、第一步：在 VS Code 中安装官方 Python 扩展

确认本地具备 Python 环境后，下一步是进入 VS Code 安装官方扩展。这一扩展是微软官方维护的工具包，它赋予了 VS Code 识别 Python 语法、自动补全、环境检测和一键运行的关键能力。

1. 进入扩展管理视图

在 VS Code 窗口最左侧的活动栏（Activity Bar）中，找到类似四个方块拼接图标的“扩展（Extensions）”按钮并点击。你也可以直接使用全局快捷键：Windows 系统下按下 Ctrl + Shift + X，macOS 系统下按下 Command + Shift + X，即可展开扩展商店侧边栏。

2. 搜索并安装官方扩展

在扩展侧边栏顶部的“在商店中搜索扩展（Search Extensions in Marketplace）”输入框中键入 Python。在搜索结果列表的最上方，你会看到名为 Python 的扩展，其发布者为 Microsoft。请特别注意辨认带有官方认证标识的条目，点击右侧蓝色的“安装（Install）”按钮。

四、第二步：为项目精确选择 Python 解释器

安装完扩展后，进入最关键的操作环节：选择解释器（Select Interpreter）。这一步的目标是明确告知 VS Code 当前工作区应当绑定哪一个具体的 Python 环境。

1. 通过命令面板唤出解释器选择列表

在 VS Code 界面中，按下全局命令面板快捷键：Windows 系统下为 Ctrl + Shift + P，macOS 系统下为 Command + Shift + P。在窗口顶部中央弹出的输入框中，输入以下文字：

Python: Select Interpreter

随着输入，列表中会出现“Python: 选择解释器（Python: Select Interpreter）”选项，点击该条目后，VS Code 将自动扫描你电脑中已安装的所有 Python 环境并列出下拉清单。

2. 理解不同解释器环境类型

在下拉列表中，你可能会看到多个带有不同标签的解释器选项。了解它们的区别有助于你做出正确的选择：

五、第三步：创建测试脚本并在内置终端中运行验证

完成扩展安装与解释器选择后，整个开发链路就已经建立完备。接下来通过创建一份极简的测试脚本进行首次运行验证。

1. 新建代码文件

点击顶部菜单栏的“文件（File）” > “新建文本文件（New Text File）”，或在文件资源管理器中新建文件，命名为 test.py。注意文件扩展名必须是 .py，这样 VS Code 才能将其识别为 Python 代码文件并激活相关的语法高亮与状态栏指示。

2. 编写验证代码

在编辑器窗口中输入以下简洁的基础代码：

# 首次运行验证代码
print("你好，VS Code 与 Python！")

items = ["编辑器配置", "扩展安装", "解释器绑定"]
for index, item in enumerate(items, start=1):
    print(f"步骤 {index}: {item} 检查通过")

3. 执行代码并查看结果

在代码编辑区域的右上角，找到一个朝右的三角形播放图标，其鼠标悬停提示为“在终端中运行 Python 文件（Run Python File in Terminal）”。点击该图标，或者在代码编辑区域点击鼠标右键，在弹出菜单中选择“在终端中运行 Python 文件”。

此时，VS Code 窗口下方会自动展开“内置终端（Terminal）”面板。你会看到终端中自动输入了一行执行指令，指向你刚才选择的 Python 解释器完整路径，并紧随其后输出程序打印的内容：

你好，VS Code 与 Python！
步骤 1: 编辑器配置 检查通过
步骤 2: 扩展安装 检查通过
步骤 3: 解释器绑定 检查通过

看到这几行输出，就意味着你的 VS Code 已经成功完成了首次 Python 脚本的调用与运行。

六、首次运行常见中断排查与边界条件

即使按照标准步骤操作，不同计算机的系统权限与初始设置差异仍可能导致运行中断。遇到问题时无需慌张，通常对应以下三种高频典型情况：

七、规范建议与高效操作速查

为了让后续的 Python 开发更加顺畅，建议养成以下两项良好习惯：

1. 始终以“文件夹（工作区）”形式打开项目

不要在 VS Code 中单独打开单个散落的 .py 脚本，而是先建立一个项目文件夹，通过“文件（File）” > “打开文件夹（Open Folder）”将其作为工作区载入。这样一来，VS Code 会在项目根目录生成 .vscode/settings.json 配置文件，记录你当前项目选定的解释器路径。下次再次打开该文件夹时，无需重复手动选择解释器。

2. 常用操作快捷键速查

掌握了安装扩展与选择解释器这两个核心动作，你就打通了 VS Code 与 Python 底层运行时之间的通道。后续无论是编写数据分析脚本、自动化办公工具还是大型项目，这套机制都将作为最稳固的基石为你提供支持。