VSCode 搭建 Python 运行与调试环境
Visual Studio Code (VSCode) 是一款功能强大的代码编辑器,通过合理的配置可以成为优秀的 Python 集成开发环境(IDE)。本文将详细介绍如何在 VSCode 中搭建 Python 运行与调试环境,涵盖从基础安装到高级调试配置的全过程。
1. 安装 Python 解释器
首先需要在系统中安装 Python 解释器。建议安装最新稳定版本,例如 Python 3.x。访问 Python 官网下载对应操作系统的安装包并按照向导完成安装。安装过程中请注意勾选"Add Python to PATH"选项,以便在命令行中直接调用。
2. 安装 VSCode
下载并安装 Visual Studio Code。安装完成后启动编辑器,确保界面正常显示。
3. 安装 Python 扩展
VSCode 的 Python 扩展提供了智能提示、代码调试、代码导航和格式化等核心功能。
- 点击左侧活动栏的"扩展"图标(或按 Ctrl+Shift+X)。
- 在搜索框中输入"Python"。
- 找到由 Microsoft 发布的"Python"扩展并点击安装。
- 安装完成后可能需要重启 VSCode。
4. 创建工程工作区
- 在本地创建一个用于存放 Python 项目的文件夹。
- 在文件夹内新建一个 Python 文件,例如
test.py。 - 在 VSCode 中选择"文件" -> "将文件夹添加到工作区",选中刚才创建的文件夹。
示例代码:
print("Hello World")
for i in range(5):
print(f"Count: {i}")
5. 选择 Python 解释器
打开 Python 文件后,VSCode 会自动检测系统中的 Python 解释器,并在窗口左下角显示当前选中的版本。
- 切换解释器:点击左下角的解释器名称,从列表中选择目标版本。
- 指定路径:如果未检测到,可选择"Select Interpreter" -> "Enter interpreter path"手动指定。
6. 运行 Python 程序
有两种常用方式运行脚本:
- 右键菜单:在编辑器中右键点击代码区域,选择"Run Python File in Terminal"。
- 顶部按钮:点击编辑器右上角的运行按钮(三角形图标)。
程序将在内置终端中输出结果。
7. 调试 Python 程序
7.1 设置调试配置
- 点击左侧活动栏的"运行和调试"图标。
- 首次使用会提示创建配置文件,选择"Python File"。
- VSCode 会在
.vscode目录下生成launch.json文件。
关键配置项说明:
name: 调试配置名称。type: 必须为python。- : 通常为 (启动调试)或 (附加调试)。


