在 VSCode 中调试 Django 项目

1. 首先确保已安装必要的 VS Code 扩展：

   • Python
   • Python Debugger
   • Django（可选但推荐）

2. 创建 launch.json 配置文件：

   • 在 VS Code 中打开你的 Django 项目
   • 点击左侧的调试图标（Run and Debug 或按 Ctrl+Shift+D）
   • 点击”创建 launch.json 文件(create a launch.json file)”
   • 选择 “Python Debugger”
   • 会在项目根目录下创建一个文件.vscode/launch.json

3. 配置 launch.json 文件，将以下配置复制到文件中：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Django",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": [
                "runserver",
                "0.0.0.0:8000"
            ],
            "django": true,
            "justMyCode": true
        }
    ]
}

解释：

• "django": true: 告诉 VS Code 这是一个 Django 项目，启用 Django 特定的调试功能，允许调试器正确处理 Django 模板，使调试器能够识别 Django 的项目结构，启用 Django 相关的异常处理。
• "justMyCode": true: 当设置为 true 时，只调试你自己写的代码，跳过标准库和第三方库的代码，使调试过程更清晰，专注于你的应用代码；当设置为 false 时，会调试所有代码，包括第三方库，可以深入了解框架内部运作，适合排查底层问题，但会使调试过程变得复杂。建议：普通开发时保持 "justMyCode": true，遇到框架相关问题时，将其设为 false 深入调试。

4. 设置断点：

   • 在需要调试的代码行左侧点击，设置断点（会出现红点）
   • 常用断点位置：视图函数、模型方法等

5. 开始调试：

按 F5 或点击绿色启动按钮开始调试，当程序执行到断点处会自动暂停。

点击调试图标（Run and Debug 或按 Ctrl+Shift+D）打开左侧调试窗口，就能看到绿色的调试启动按钮了。

如果启动调试后报错，可能是插件安装未生效，重新加载一下窗口（Ctrl + shift + P，“Reload Window”）。

6. 调试过程中的常用操作：

   • F5：继续执行
   • F10：单步跳过（Step Over）
   • F11：单步进入（Step Into）
   • Shift+F11：单步跳出（Step Out）
   • F9：启用/禁用断点

7. 调试窗口中的重要信息：

   • Variables：查看当前变量值
   • Watch：监视特定表达式
   • Call Stack：查看调用堆栈
   • Debug Console：交互式调试控制台

8. 高级调试技巧：

   • 条件断点：右击断点，设置条件表达式
   • 监视变量：在 VARIABLES 窗口右击变量，添加到监视
   • 修改变量：在调试过程中可以修改变量值