解决 VS Code Django 项目调试器无法工作的问题-Python教程-PHP中文网

解决 VS Code Django 项目调试器无法工作的问题

心靈之曲

发布： 2025-08-27 23:23:01

原创

469人浏览过

解决 vs code django 项目调试器无法工作的问题

本文旨在帮助开发者解决在使用 VS Code 调试 Django 项目时遇到的调试器无法正常工作的问题。我们将详细检查 launch.json 配置文件、Python 环境配置以及项目结构，并提供逐步排查和解决问题的方法，确保调试器能够正确地在断点处停止，从而提高开发效率。

在使用 VS Code 进行 Django 项目开发时，调试器无法正常工作是一个常见问题。这通常表现为调试器启动后，程序持续运行，不会在断点处停止，状态栏颜色也没有变为橙色。以下提供一些排查和解决此问题的步骤：

确保 VS Code 打开的根目录是包含 manage.py 文件的目录。如果根目录不正确，调试器可能无法正确识别 Django 项目的入口点。

VS Code 需要使用正确的 Python 解释器来运行和调试 Django 项目。特别是使用了虚拟环境的项目，必须确保 VS Code 选择的是虚拟环境中的 Python 解释器。

检查方法： 在 VS Code 中，查看状态栏右下角显示的 Python 解释器。如果不是所需的虚拟环境，点击该区域，然后选择正确的 Python 解释器。
设置方法： 可以通过在 VS Code 的设置中搜索 "Python: Select Interpreter" 来手动选择 Python 解释器。

launch.json 文件配置不正确是导致调试器无法工作的常见原因。请确保该文件中的配置项正确。

位置： 该文件位于项目根目录下的 .vscode 文件夹中。
配置示例：
```
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Django",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": [
                "runserver"
            ],
            "django": true,
            "justMyCode": true
        }
    ]
}
```
登录后复制
- program: 指定 manage.py 文件的路径，通常设置为 ${workspaceFolder}/manage.py，表示项目根目录下的 manage.py 文件。
- args: 指定传递给 manage.py 的参数，通常设置为 ["runserver"]，表示运行 Django 开发服务器。
- django: 设置为 true，启用 Django 调试支持。
- justMyCode: 设置为 true，只调试用户编写的代码，忽略 Django 框架的代码。