Django项目中HTML引用CSS路径错误及模板语法问题求助

问题根因 #

静态文件加载404是因为Django未正确识别应用下的静态文件目录，你后续修改模板标签的方式不符合Django语法规范，因此触发TemplateSyntaxError。

正确解决方案 #

1. 确认应用已注册到INSTALLED_APPS #

打开项目根目录的settings.py，确保helloworld应用已加入INSTALLED_APPS列表：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 注册你的应用
    'helloworld',
]

Django仅会扫描已注册应用下的static目录，未注册的话静态文件无法被识别。

2. 修正模板中的静态文件引用语法 #

你之前修改的标签缺失static关键字，正确写法需保留{% static %}标签，路径仅需填写应用static目录下的相对路径：

{% load static %}
<link rel="stylesheet" type="text/css" href="{% static 'hello/site.css' %}" />

在开发模式下，Django会自动将该路径映射为/static/hello/site.css，同时从helloworld/static/hello/site.css读取文件（前提是应用已注册）。

3. 验证静态文件服务 #

启动开发服务器后，直接访问http://localhost:8000/static/hello/site.css，若能正常显示CSS内容，说明配置生效，页面样式即可正常加载。

（可选）自定义静态文件目录配置 #

如果静态文件不在应用目录内，可在settings.py中添加STATICFILES_DIRS指定额外路径：

STATICFILES_DIRS = [
    BASE_DIR / "helloworld" / "static",
]

应用已注册时通常无需此步骤，但若有额外静态资源目录可按需配置。

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