在VSCode中调试Werkzeug+Django应用时出现“No module named manage”错误

数据老陈

2026-8-12

问题分析与解决

错误原因及修复步骤

1. 统一路径分隔符

你的launch.json中program字段混合使用了正斜杠/和反斜杠\，Windows环境下可能导致路径识别异常，需统一为一种格式：

"program": "${workspaceFolder}/appname/manage.py"

或

"program": "${workspaceFolder}\\appname\\manage.py"

2. 指定正确的工作目录

调试时Python默认工作目录是${workspaceFolder}，但manage.py位于appname子目录下，会导致Django无法正确识别项目结构。添加cwd字段指定到manage.py所在目录：

"cwd": "${workspaceFolder}/appname"

3. 避免Django调试配置冲突

使用runserver_plus（来自django-extensions）时，VSCode内置的"django": true配置可能引发冲突，建议设置为false：

"django": false

4. 验证依赖是否安装

runserver_plus属于django-extensions模块，需确保虚拟环境已安装相关依赖：

${workspaceFolder}/venv/Scripts/pip install django-extensions werkzeug

修复后的完整`launch.json`示例

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Django HTTPS",
            "type": "python",
            "request": "launch",
            "python": "${workspaceFolder}/venv/Scripts/python.exe",
            "program": "${workspaceFolder}/appname/manage.py",
            "cwd": "${workspaceFolder}/appname",
            "args": [
                "runserver_plus",
                "--cert-file",
                "${workspaceFolder}/certs/cert.pem",
                "--key-file",
                "${workspaceFolder}/certs/key.pem"
            ],
            "justMyCode": false,
            "django": false
        }
    ]
}