VS Code中Django项目launch.json调试失效问题求助

核心症状：调试器启动后持续运行无报错，VS Code状态栏未变为橙色，设置在views.py第9行的断点完全不触发；手动运行python manage.py runserver项目正常，网页输出符合预期。

以下是针对性排查步骤：

• 确认Python解释器匹配
  左下角状态栏显示的Python解释器必须是项目虚拟环境的那个。点击状态栏的Python版本，选择项目虚拟环境下的解释器（比如./venv/bin/python或.\venv\Scripts\python.exe）。调试器如果用了全局Python，可能找不到Django依赖，导致调试流程异常。

• 修正launch.json配置

  1. 检查program路径：如果是Windows系统，${workspaceFolder}\\manage.py没问题，但要确保VS Code打开的工作区是包含manage.py的根目录；如果是Linux/macOS，把路径分隔符换成/。
  2. 暂时关闭justMyCode：把"justMyCode": true改成"justMyCode": false，这个选项会让调试器跳过非自己编写的代码，但Django的请求处理流程需要调试器介入框架代码才能触发断点。
  3. 可选：替换成绝对路径测试，比如"program": "C:\\your-project-path\\manage.py"，排除变量解析问题。

• 验证断点有效性

  1. 确保断点设置在会执行的代码分支：比如要触发views.py第9行的断点，必须访问对应的URL（比如http://localhost:8000/hello/Test），直接访问首页不会走到这个函数。
  2. 检查断点图标：如果断点是灰色空心圆，说明调试器未关联到该文件，大概率是解释器选错了，或者文件不在调试上下文里。

• 查看调试控制台日志
  启动调试后，切换到“调试控制台”面板，查看是否有隐藏的警告或错误（比如环境变量缺失、模块导入失败），手动运行和调试时的环境变量可能存在差异。

• 更新VS Code Python扩展
  旧版本的Python扩展可能存在Django调试兼容性问题，打开扩展商店，找到Python扩展点击“更新”，重启VS Code后再试。

附用户提供的配置参考：

launch.json：

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Django",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}\\manage.py",
            "args": [
                "runserver"
            ],
            "django": true,
            "justMyCode": true
        }
    ]
}

views.py：

import re
from django.utils.timezone import datetime
from django.http import HttpResponse

def home(request):
    return HttpResponse("Hello, Django!")

def hello_there(request, name):
    now = datetime.now()
    formatted_now = now.strftime("%A, %d %B, %Y at %X")

    # Filter the name argument to letters only using regular expressions. URL arguments
    # can contain arbitrary text, so we restrict to safe characters only.
    match_object = re.match("[a-zA-Z]+", name)

    if match_object:
        clean_name = match_object.group(0)
    else:
        clean_name = "Friend"

    content = "Hello there, " + clean_name + "! It's " + formatted_now
    return HttpResponse(content)

manage.py：

#!/usr/bin/env python
"""Django's command-line utility for administrative tasks."""
import os
import sys


def main():
    """Run administrative tasks."""
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'web_project.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)


if __name__ == '__main__':
    main()

内容的提问来源于stack exchange，提问作者Koen