VS Code中怎么配置并运行Python代码文件

在 Visual Studio Code（简称 VS Code）中配置并运行 Python 代码，核心逻辑非常简单：安装官方 Python 扩展以赋予编辑器语法与调试支持，再为当前工作区绑定一个有效的本地 Python 解释器，最后通过编辑器按钮或终端执行脚本。VS Code 本身是一个轻量级的通用代码编辑器，它不自带 Python 编译器或运行环境，因此所有代码最终都是交由操作系统中安装的实际 Python 内核来解释执行的。

第一步：确认本地已安装 Python 运行环境

配置 VS Code 的前置条件是你的计算机上已经安装好 Python。VS Code 只是代码书写与调试的界面，本身不包含 Python 编译器。

请先验证本地是否能直接调用 Python。打开操作系统的终端（Windows 上的 CMD 或 PowerShell，macOS / Linux 上的 Terminal），输入以下命令：

python --version

或者在部分类 Unix 系统中执行：

python3 --version

如果终端正确返回了版本号（例如 Python 3.11.8），说明环境已准备就绪。如果提示“未找到命令”或不是内部外部命令，需要前往 Python 官方网站下载安装包。在 Windows 上安装时，务必勾选安装向导底部的 "Add python.exe to PATH"（将 Python 添加到系统环境变量），否则后续 VS Code 无法自动扫描到解释器。

第二步：在 VS Code 中安装官方 Python 扩展

原生 VS Code 默认仅提供基本的代码着色。若要获得代码补全、运行控制、语法检查和调试支持，必须安装 Microsoft 官方发布的 Python 插件。

1. 启动 VS Code。
2. 点击左侧活动栏的 Extensions（扩展） 图标（快捷键为 Ctrl+Shift+X，macOS 为 Cmd+Shift+X）。
3. 在顶部搜索框中输入 Python。
4. 找到由 Microsoft 官方发布的条目（通常排在第一位），点击 Install（安装）。

安装该扩展时，VS Code 会自动附带安装 Pylance（提供高性能的代码静态分析与自动补全）和 Python Debugger（提供断点调试支持）。安装完毕后无需重启，功能立即生效。

第三步：打开工作文件夹并选择 Python 解释器

许多初学者直接在 VS Code 里新建单文件写代码，这会导致工作区上下文缺失。推荐的做法是先打开一个固定的项目文件夹。

点击菜单栏 File（文件）> Open Folder（打开文件夹），选中或新建一个本地工作目录（例如 my_python_project）。

绑定正确的 Python 解释器

解释器决定了 VS Code 使用哪个 Python 环境来执行你的代码和加载第三方库。

1. 按下快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）调出全局命令面板。
2. 输入 Python: Select Interpreter 并按回车。
3. 列表中会列出系统检测到的所有 Python 环境（包括全局安装路径、Conda 环境或虚拟环境 venv）。选择你打算使用的 Python 版本（推荐带有 Recommended 标签的全局环境或本地项目虚拟环境）。

选中解释器后，VS Code 窗口右下角（或状态栏左侧）会显示当前生效的 Python 版本（如 3.11.8 64-bit）。此时，环境配置便全部完成。

第四步：新建并运行 Python 代码文件

在左侧资源管理器中，点击“新建文件”按钮，命名为 main.py（扩展名必须是 .py）。在编辑器中输入测试代码：

def greet(name: str):
    message = f"Hello, {name}! VS Code is running Python successfully."
    return message

if __name__ == "__main__":
    result = greet("Developer")
    print(result)

运行该文件有三种常见方式，可以根据场景灵活选用：

1. 右上角运行按钮（最简便）

在打开 main.py 的状态下，观察代码窗口右上角，可以看到一个三角样式的 Play（运行） 图标。点击它，VS Code 会在下方自动唤起集成终端，并自动生成执行命令：

# 终端中自动生成的执行示例
/usr/bin/python3 "/Users/username/my_project/main.py"

在下方终端窗口中，即可看到输出结果：

Hello, Developer! VS Code is running Python successfully.

2. 集成终端直接敲命令（最灵活）

按下快捷键 Ctrl+`（即数字 1 左侧的飘号键）即可打开 VS Code 内置终端。在终端中直接敲入：

python main.py

这种方式与在外部命令行操作完全一致，不仅支持使用 python main.py --input test.csv 传递参数，还可以方便地结合 pip 安装第三方依赖。

3. 断点单步调试（排查逻辑错误）

当代码出现隐蔽错误时，可以通过断点调试观察内部执行过程：

1. 把鼠标移到 main.py 中第 2 行代码（message = ...）行号左侧的微小空隙，单击鼠标左键，此时会出现一个红色的实心圆点（断点）。
2. 按键盘 F5（或点击左侧调试图标选择“Run and Debug”），在弹出选项中选择 Python Debugger: Python File。
3. 程序会启动并在红点处挂起暂停。左侧面板将实时展开当前的局部变量值（name 的值）、调用堆栈；顶部会出现单步跳过（F10）、单步进入（F11）的操作条。

常见问题与排错指南

在初次配置过程中，绝大多数问题都源于环境变量或解释器版本选择不一致。以下是三类最高频的问题及排查方案：

1. 报错 ModuleNotFoundError: No module named 'xxx'

明明在电脑里执行了 pip install pandas，但在 VS Code 运行代码时依然报找不到模块。这是因为系统里存在多个 Python 版本（如系统自带的 Python、Anaconda 环境、独立的 Python 3.11 等），你使用 pip 安装依赖的环境与 VS Code 当前选中的解释器不是同一个。

解决办法：按下 Ctrl+Shift+P 重新执行 Python: Select Interpreter，切换为你安装了该第三方库的具体环境路径；或者直接在 VS Code 内置终端中，明确使用当前解释器进行安装：

# 保证当前使用的解释器与其 pip 绝对一致
python -m pip install 库名称

2. Windows 下提示“无法加载文件，因为在此系统上禁止运行脚本”

这是因为 Windows 系统的 PowerShell 默认安全策略禁止运行激活虚拟环境的脚本（例如 activate.ps1）。

解决办法：最便捷的方式是点击终端窗口右上角下拉菜单，将默认终端从 PowerShell 切换为 Command Prompt（CMD）；若希望继续使用 PowerShell，可以以管理员身份打开 PowerShell，执行一次：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 并选择确认即可。

核心配置清单总结

掌握了上述“安装 Python → 装插件 → 选解释器 → 运行”四个核心环节后，后续无论是编写简单的单文件数据处理脚本，还是引入虚拟环境构建大型 Web 项目，整体运行原理都是完全一致的。