Django无法加载CSS文件：已尝试多种方案仍未解决

问题详情 #

我的Django项目里CSS文件始终无法链接到HTML模板，试过了能找到的几乎所有方案——加了推荐的URL模式、用绝对路径替代相对路径、严格按官方文档配置，还是没解决问题。

当前配置（settings.py） #

STATIC_URL = '/static/'

STATICFILES_DIRS = [
  os.path.join(BASE_DIR, 'static')
]

文件路径 #

BASE_DIR/static/css/main.css

模板代码（store.html） #

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

<h3>Store</h3>

错误信息 #

GET http://127.0.0.1:8000/static/css/main.css net::ERR_ABORTED 404 (Not Found)
GET /static/css/main.css HTTP/1.1" 404

排查解决步骤 #

• 验证BASE_DIR路径：在settings.py中添加print(BASE_DIR)，运行项目查看控制台输出，确认它指向项目根目录，且static文件夹确实存在于该目录下。
• 完善URL配置：在项目根urls.py中添加静态文件路由配置：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 你的现有URL配置
  ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
  

  开发环境下runserver虽会自动处理静态文件，但手动添加该配置可解决部分路径识别异常。
• 改用模板标签生成路径：替换硬编码的静态文件路径，使用{% static %}标签确保路径与配置一致：

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

• 检查文件权限：确保static文件夹及内部css文件拥有可读权限（Linux/macOS环境下需特别注意）。
• 强制刷新浏览器：按Ctrl+Shift+R清除缓存后重新加载页面，避免旧的404响应缓存影响。
• 确认STATIC_ROOT配置（部署场景）：若为生产环境，需执行python manage.py collectstatic将静态文件统一收集到STATIC_ROOT指定目录；开发环境无需此操作，但要避免STATIC_ROOT与STATICFILES_DIRS路径冲突。

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