安装Python扩展和解释器,2. 创建项目并编写代码,3. 生成launch.json配置调试,4. 设置断点并F5启动,5. 调试时查看变量和输出,快速定位问题。

在 VS Code 中调试 Python 应用程序并不复杂,只要配置正确,可以快速定位问题并提升开发效率。以下是完整且实用的操作步骤。
1. 安装必要组件
确保你的开发环境已准备就绪:
- 安装 Python 扩展:打开 VS Code,进入扩展市场(Ctrl+Shift+X),搜索“Python”,由微软官方提供,点击安装。
- 安装 Python 解释器:确保系统中已安装 Python,并能在终端中通过 python --version 或 python3 --version 正常输出版本号。
- VS Code 会自动检测可用的解释器,若未自动提示,请手动选择:按 Ctrl+Shift+P,输入“Python: Select Interpreter”,然后选择合适的版本。
2. 创建或打开 Python 项目
打开包含 Python 文件的文件夹。建议将项目放在一个独立目录中,例如 my_project/,并在其中创建一个测试脚本如 app.py:
def greet(name):return f"Hello, {name}"
print(greet("Alice"))
3. 配置调试器(launch.json)
VS Code 使用 launch.json 文件定义调试设置。首次调试时可自动生成:
立即学习“Python免费学习笔记(深入)”;
- 点击左侧活动栏的“运行和调试”图标(虫子形状)。
- 点击“创建 launch.json 文件”,选择“Python”环境。
- 选择“Python File”作为默认配置,这会启动当前打开的文件。
生成的 .vscode/launch.json 内容类似:
{"version": "0.2.0",
"configurations": [
{
"name": "Python File",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}
4. 设置断点并启动调试
调试的核心是观察程序执行流程:
- 在代码行号左侧点击,添加断点(红点)。例如,在 return f"Hello, {name}" 这一行设断点。
- 按下 F5 或点击“运行和调试”视图中的“运行”按钮。
- 程序会在断点处暂停,此时可在侧边栏查看变量值、调用堆栈等信息。
- 使用顶部调试工具栏进行单步执行(Step Over)、进入函数(Step Into)、跳出(Step Out)等操作。
5. 查看输出与调试信息
调试过程中:
- 变量面板会显示当前作用域内的所有变量及其值。
- “调试控制台”允许你输入 Python 表达式实时求值,比如输入 name 可看到其值为 "Alice"。
- 程序输出会显示在集成终端中,便于观察 print 输出或异常信息。
基本上就这些。配置一次后,后续调试只需设断点并按 F5。只要解释器选对、launch.json 存在,调试就能顺利运行。










