DEBUG=True时Django静态文件仅VS Code调试可见（使用Daphne服务器）

当DEBUG=True时，直接运行python manage.py runserver静态文件无法加载，但通过VS Code调试器启动同一个runserver命令时，静态文件却能正常显示。当前已集成Daphne作为服务器。

相关配置 #

settings.py核心配置 #

STATIC_ROOT = BASE_DIR / 'static'
STATIC_URL = 'static/'
INSTALLED_APPS = [
    ...
    'django.contrib.staticfiles',
    ...
]

BASE_DIR = Path(__file__).resolve().parent.parent

urls.py配置 #

urlpatterns = [
    ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

VS Code launch.json配置 #

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python Debugger: Django",
            "type": "debugpy",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": ["runserver"],
            "django": true,
            "autoStartBrowser": false,
            "justMyCode": false,
        }
    ]
}

静态文件存储在各应用的static/目录下。

问题原因及解决办法 #

1. 核心原因：服务器类型差异触发的静态服务逻辑 #

Django的django.contrib.staticfiles在DEBUG模式下，只有当请求由Django自带的WSGI服务器处理时，才会自动扫描各应用下的static/目录并提供静态文件服务。但你集成了Daphne（ASGI服务器），直接运行runserver时，Django会默认使用Daphne启动，而Daphne不会自动处理零散在各应用中的静态文件。

而VS Code调试器的django: true配置，会强制调用Django的WSGI服务器启动，这时候静态文件的自动服务逻辑就正常触发了。

2. 具体解决办法 #

方案一：手动指定用WSGI服务器启动

直接在终端运行命令时，显式指定服务器类型为WSGI：

python manage.py runserver --server-type wsgi

方案二：让Daphne能处理静态文件（适合调试ASGI场景）

如果需要用Daphne调试，需要手动配置静态文件路由并收集文件：

1. 先执行收集命令，把所有应用的静态文件统一放到STATIC_ROOT目录：

python manage.py collectstatic

2. 在urls.py中添加静态文件的路由（仅DEBUG模式生效）：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

这样Daphne就能找到收集后的静态文件并提供服务。

方案三：检查环境变量一致性

VS Code调试器可能会自动设置DJANGO_SETTINGS_MODULE等环境变量，和你直接在终端运行时的环境可能不一致。可以分别在终端和调试器的控制台执行以下命令对比：

# Linux/macOS
echo $DJANGO_SETTINGS_MODULE
# Windows
echo %DJANGO_SETTINGS_MODULE%

如果不一致，要么调整终端的环境变量，要么在launch.json中显式指定：

"env": {
    "DJANGO_SETTINGS_MODULE": "你的项目名.settings"
}

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