向Django项目添加main.css文件失败，求有效解决方案

1. 调整项目结构 #

• 在项目根目录创建 static 文件夹，内部再新建 css 子文件夹，将 main.css 放入其中，最终结构如下：

  你的项目名/
  ├── 项目配置文件夹/
  ├── static/
  │   └── css/
  │       └── main.css
  ├── 应用文件夹/
  └── manage.py
  

2. 修改项目 settings.py 配置 #

• 确认 INSTALLED_APPS 列表中包含 django.contrib.staticfiles（默认已存在）
• 在文件末尾添加以下配置：

  STATIC_URL = '/static/'
  STATICFILES_DIRS = [
      BASE_DIR / "static",
  ]
  

  注意：若使用 Django 3.1 及以下版本，将 BASE_DIR / "static" 替换为 os.path.join(BASE_DIR, "static")

3. 在 HTML 模板中引入 CSS #

• 在模板头部先加载静态文件标签，再引入 main.css：

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

4. 测试前的必要操作 #

• 运行开发服务器前，执行收集静态文件命令（开发环境可跳过，但生产环境必须执行）：

  python manage.py collectstatic
  

• 重启开发服务器，刷新页面验证效果

常见问题排查 #

• 检查 STATIC_URL 与模板中 {% static %} 路径是否完全匹配
• 确认 main.css 的文件名、路径拼写无错误（注意大小写敏感）
• 打开浏览器控制台查看网络请求，若 CSS 文件返回 404，核对路径配置
• 确保模板中 {% load static %} 标签放在 <link> 标签之前

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