0

0

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

看不見的法師

看不見的法師

发布时间:2025-08-12 10:29:01

|

1217人浏览过

|

来源于php中文网

原创

安装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免费学习笔记(深入)”;

  1. 安装Python扩展:确保VSCode中安装了Python扩展。这通常是第一步,因为这个扩展提供了调试、代码补全等核心功能。没有它,一切都无从谈起。

  2. 创建或打开Python项目:在VSCode中打开你的Python项目文件夹。如果还没有项目,可以创建一个新的Python文件。

  3. 配置调试环境(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
      ,调试器会跳过这些代码。
  4. 设置断点:在你想暂停执行的代码行左侧点击,或者使用

    F9
    快捷键。断点会在编辑器中显示为一个红点。

  5. 启动调试:点击“运行和调试”视图中的绿色箭头,或者按

    F5
    键。VSCode会启动调试器,并在第一个断点处暂停。

  6. 调试操作:

    • 继续 (F5): 继续执行到下一个断点,如果没有断点,则执行到程序结束。
    • 单步跳过 (F10): 执行当前行,然后跳到下一行。如果当前行是一个函数调用,则直接执行完函数,不进入函数内部。
    • 单步进入 (F11): 如果当前行是一个函数调用,则进入函数内部。
    • 单步跳出 (Shift+F11): 从当前函数中跳出,返回到调用函数的地方。
    • 重新启动 (Ctrl+Shift+F5): 重新启动调试会话。
    • 停止 (Shift+F5): 停止调试会话。
  7. 检查变量:在“运行和调试”视图中,你可以查看当前作用域内的变量值。也可以使用“调试控制台”来执行Python代码,查看表达式的值。

    万兴喵影
    万兴喵影

    国产剪辑神器

    下载
  8. 高级调试技巧:

    • 条件断点: 在断点上右键,选择“编辑断点”,可以设置断点触发的条件。例如,只有当变量
      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”怎么办?

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

  1. 找到占用该端口的进程,并将其杀死。可以使用
    lsof -i :<端口号>
    (Linux/macOS)或者
    netstat -ano | findstr <端口号>
    (Windows)命令来查找占用端口的进程。
  2. 更改
    launch.json
    中指定的端口号。

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

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

751

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

636

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1262

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

706

2023.08.11

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

10

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
go语言零基础开发内容管理系统
go语言零基础开发内容管理系统

共34课时 | 2.5万人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 7.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号