VSCode如何调试Python程序 VSCode调试Python代码的详细步骤-VSCode-PHP中文网

VSCode如何调试Python程序 VSCode调试Python代码的详细步骤

看不見的法師

发布： 2025-08-12 10:29:01

原创

1196人浏览过

安装python扩展是调试的前提，2. 创建或打开项目后配置launch.json文件，3. 通过设置断点并启动调试器开始调试，4. 利用f5、f10、f11等快捷键进行单步执行和流程控制，5. 在调试视图中检查变量和执行表达式，6. 使用条件断点、日志断点等高级技巧提升效率，7. 调试第三方库需设置"justmycode": false并确保有源码，8. 调试flask或django应用时需配置module、env和args以正确启动服务，9. 远程调试需在服务器安装debugpy并配置远程连接信息，10. 遇到端口占用错误时应查找并终止占用进程或更改端口，所有步骤完成后即可实现高效python调试。

VSCode如何调试Python程序 VSCode调试Python代码的详细步骤

VSCode调试Python程序，简单来说，就是配置好launch.json，然后打断点，愉快地debug。但是，细节往往藏在魔鬼里。

配置launch.json，设置断点，启动调试器，检查变量，单步执行，这些是基本操作。但要真正高效地调试Python代码，还需要了解一些更深入的技巧和方法。

VSCode调试Python代码的详细步骤

立即学习“Python免费学习笔记（深入）”；

安装Python扩展：确保VSCode中安装了Python扩展。这通常是第一步，因为这个扩展提供了调试、代码补全等核心功能。没有它，一切都无从谈起。
创建或打开Python项目：在VSCode中打开你的Python项目文件夹。如果还没有项目，可以创建一个新的Python文件。
配置调试环境（launch.json）：这是关键的一步。
- 点击VSCode侧边栏的“运行和调试”图标（或者按
```
Ctrl+Shift+D
```
  登录后复制
  ）。
- 点击“创建launch.json文件”。
- 选择“Python File”或者“Python Module”等合适的配置。
一个典型的
```
launch.json
```
登录后复制
文件可能看起来像这样：
```
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": false
        }
    ]
}
```
登录后复制
- ```
"program": "${file}"
```
  登录后复制
  表示调试当前打开的文件。
- ```
"console": "integratedTerminal"
```
  登录后复制
  表示在集成终端中运行程序。
- ```
"justMyCode": false
```
  登录后复制
  很重要，它允许你调试标准库和第三方库的代码。如果设为
```
true
```
  登录后复制
  ，调试器会跳过这些代码。
设置断点：在你想暂停执行的代码行左侧点击，或者使用
```
F9
```
登录后复制
快捷键。断点会在编辑器中显示为一个红点。
启动调试：点击“运行和调试”视图中的绿色箭头，或者按
```
F5
```
登录后复制
键。VSCode会启动调试器，并在第一个断点处暂停。
调试操作：
- 继续 (F5): 继续执行到下一个断点，如果没有断点，则执行到程序结束。
- 单步跳过 (F10): 执行当前行，然后跳到下一行。如果当前行是一个函数调用，则直接执行完函数，不进入函数内部。
- 单步进入 (F11): 如果当前行是一个函数调用，则进入函数内部。
- 单步跳出 (Shift+F11): 从当前函数中跳出，返回到调用函数的地方。
- 重新启动 (Ctrl+Shift+F5): 重新启动调试会话。
- 停止 (Shift+F5): 停止调试会话。
检查变量：在“运行和调试”视图中，你可以查看当前作用域内的变量值。也可以使用“调试控制台”来执行Python代码，查看表达式的值。

Chromox
Chromox是一款领先的AI在线生成平台，专为喜欢AI生成技术的爱好者制作的多种图像、视频生成方式的内容型工具平台。

184

查看详情
高级调试技巧：
- 条件断点: 在断点上右键，选择“编辑断点”，可以设置断点触发的条件。例如，只有当变量
```
i
```
  登录后复制
  的值大于10时，断点才会暂停。
- 日志断点: 类似于条件断点，但不会暂停程序，而是在控制台中输出一条日志消息。这对于调试复杂的逻辑非常有用，可以避免频繁地暂停程序。
- 多线程调试: VSCode支持多线程调试。在调试多线程程序时，可以查看每个线程的状态，并在不同的线程之间切换。

如何调试import的第三方库？

确保

launch.json

登录后复制

中

"justMyCode": false

登录后复制

，这样调试器就不会跳过第三方库的代码。另外，你可能需要在第三方库的代码中设置断点，以便调试器能够暂停。如果第三方库的代码没有源代码（例如，只有编译后的二进制文件），则可能无法调试。不过，大多数流行的Python库都有源代码，所以通常不是问题。

如何调试Flask或Django等Web应用？

对于Web应用，

launch.json

登录后复制

的配置会略有不同。你需要告诉调试器如何启动你的Web应用。例如，对于Flask应用，可以这样配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Flask",
            "type": "python",
            "request": "launch",
            "module": "flask",
            "env": {
                "FLASK_APP": "your_app.py",
                "FLASK_DEBUG": "1"
            },
            "args": [
                "run",
                "--no-debugger",
                "--no-reload"
            ],
            "justMyCode": false
        }
    ]
}

登录后复制

```
"module": "flask"
```
登录后复制
表示使用Flask模块来启动应用。
```
"env": { "FLASK_APP": "your_app.py", "FLASK_DEBUG": "1" }
```
登录后复制
设置环境变量，指定Flask应用的文件和启用调试模式。
```
"args": [ "run", "--no-debugger", "--no-reload" ]
```
登录后复制
传递给Flask的参数，禁用Flask自带的调试器和自动重载，以便VSCode的调试器可以正常工作。

调试Django应用的配置类似，只是需要指定Django的

manage.py

登录后复制

文件。

如何调试远程服务器上的Python程序？

VSCode也支持远程调试。这需要一些额外的配置，例如，在远程服务器上安装

debugpy

登录后复制

库，并在

launch.json

登录后复制

中指定远程服务器的地址和端口。具体的步骤可以参考VSCode的官方文档。远程调试对于调试部署在服务器上的应用非常有用。

调试时遇到“OSError: [Errno 98] Address already in use”怎么办？

这个错误通常表示端口被占用。这可能是因为之前启动的调试会话没有正常关闭，或者有其他程序占用了该端口。解决办法是：

找到占用该端口的进程，并将其杀死。可以使用
```
lsof -i :<端口号>
```
登录后复制
（Linux/macOS）或者
```
netstat -ano | findstr <端口号>
```
登录后复制
（Windows）命令来查找占用端口的进程。
更改
```
launch.json
```
登录后复制
中指定的端口号。

确保每次调试结束后都正常停止调试会话，可以避免端口被占用的问题。

以上就是VSCode如何调试Python程序 VSCode调试Python代码的详细步骤的详细内容，更多请关注php中文网其它相关文章！