vscode python 如何debug
时间: 2025-06-30 08:54:28 浏览: 24
### VSCode Python调试配置和使用方法
在VSCode中调试Python代码,需要进行适当的配置以确保调试过程顺利。以下是详细的配置和使用方法:
#### 1. 安装必要的扩展
首先,确保安装了Microsoft官方提供的Python扩展[^2]。该扩展支持多种调试功能,并且兼容Windows、Linux和macOS平台。
#### 2. 创建`launch.json`文件
VSCode的调试配置存储在`.vscode/launch.json`文件中。如果没有该文件,可以通过点击调试视图(左侧活动栏中的调试图标)并选择“创建一个`launch.json`文件”来生成。
以下是一个基本的`launch.json`配置示例,适用于调试当前打开的Python文件[^3]:
```json
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: 当前文件",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal",
"justMyCode": true
}
]
}
```
- `name`: 调试配置的名称,显示在调试下拉菜单中。
- `type`: 调试器类型,对于Python代码应设置为`python`。
- `request`: 调试模式,`launch`表示启动新程序,`attach`表示附加到已运行的程序。
- `program`: 要运行的程序路径,`${file}`表示当前打开的文件。
- `console`: 程序输出位置,推荐使用`integratedTerminal`(内置终端)。
- `justMyCode`: 是否仅调试用户代码,`true`表示忽略库代码。
#### 3. 配置单元测试调试
如果需要调试基于`unittest`框架的测试代码,可以在`settings.json`中添加以下配置[^4]:
```json
"python.testing.unittestArgs": [
"-v",
"-s",
"./core/tests/",
"-p",
"test_*.py"
]
```
- `-v`: 显示详细信息。
- `-s`: 指定测试目录路径。
- `-p`: 指定测试文件的匹配模式。
然后,在`launch.json`中添加一个针对单元测试的配置项:
```json
{
"name": "Python: 单元测试",
"type": "python",
"request": "launch",
"module": "unittest",
"console": "integratedTerminal"
}
```
#### 4. 启动调试
完成上述配置后,可以通过以下步骤启动调试:
- 在左侧活动栏中选择调试图标。
- 从调试下拉菜单中选择所需的调试配置。
- 点击绿色的“开始调试”按钮或按`F5`键。
#### 5. 远程调试(可选)
如果需要在远程Linux服务器上调试Python代码,可以参考高级配置指南[^2]。具体步骤包括:
- 配置SSH连接。
- 安装并启用Remote - SSH扩展。
- 在远程服务器上安装Python调试器。
---
阅读全文
相关推荐











