VSCode如何运行Django项目_VSCode配置Python Web环境-VSCode-PHP中文网

vscode运行django项目必须手动对齐解释器、启动模块和环境变量三者，否则必现modulenotfounderror或断点失效；需选虚拟环境解释器、launch.json设"module":"django"及"--noreload"、urls.py显式注册static()路由。

vscode如何运行django项目_vscode配置python web环境

VSCode 不能“直接运行”Django 项目，必须手动对齐解释器、启动模块和环境变量三者，否则必然卡在 ModuleNotFoundError: No module named 'django' 或断点完全不触发。

Python 解释器必须指向装了 Django 的虚拟环境

VSCode 不继承你终端里 source venv/bin/activate 的状态，它只认你在 UI 里手动选的那个 python 可执行文件路径。选错解释器，90% 的问题就在这一步。

按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并选择 Python: Select Interpreter
从列表中只选带 venv 或 env 字样的路径，例如：./venv/bin/python（Linux/macOS）或 .\venv\Scripts\python.exe（Windows）
绝对别选 /usr/bin/python3 或 C:\Python312\python.exe 这类系统路径——Django 很可能根本没装在那里
选完立刻看窗口右下角是否显示该路径；再新开终端执行 which python（macOS/Linux）或 where python（Windows），输出必须一致

launch.json 必须用 `"module": "django"`，不能用 `program`

设 "program": "./manage.py" 是最常见误区：VSCode 会把它当普通脚本执行，跳过 Django 自己的命令解析流程，导致 DJANGO_SETTINGS_MODULE 不生效、runserver 不真正启动、断点打在视图函数上也完全不命中。

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

在项目根目录建 .vscode/launch.json，内容至少包含："module": "django"、"args": ["runserver", "--noreload", "8000"]
--noreload 是硬性要求：Django 默认 fork 子进程处理请求，调试器只能附着在主进程，不加这个参数，断点永远不亮
"env" 字段必须显式写："DJANGO_SETTINGS_MODULE": "myproject.settings"（替换成你真实的模块路径，不是文件路径）
如果用了多 settings 文件（如 settings/dev.py），这里填 myproject.settings.dev，且确保该模块能被 import

静态文件 404？检查 `urls.py` 是否注册了 `static()`

DEBUG=True 不等于静态文件自动可访问。Django 开发服务器默认只在 URL 匹配 STATIC_URL 时才代管静态文件，但前提是主 urls.py 里显式调用了 static() 函数注册路由。

打开主 urls.py（通常是 myproject/urls.py），确认有这两行：
from django.conf import settings
from django.conf.urls.static import static
并在 urlpatterns 列表末尾加上：+ static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
注意：这段只应在 DEBUG=True 时启用，生产环境必须由 Nginx 等反向代理处理静态文件

最容易被忽略的是：所有配置都依赖 manage.py 在项目根目录。如果它被挪到子目录（比如 src/manage.py），launch.json 就得改用 "module": "django.core.management" 并加 "--pythonpath" 参数，否则连 runserver 命令都找不到。