Django静态文件配置问题求助：已尝试配置仍无法加载CSS/JS

1. 确认文件目录结构正确性 #

你的项目目录需符合如下结构，确保静态文件路径无误：

项目根目录/
    manage.py
    项目配置文件夹/
        settings.py
    static/
        main.css
    templates/
        你的模板文件.html

检查main.css是否确实存放在BASE_DIR/static/目录下。

2. 完善settings.py相关配置 #

除现有配置外，需确保以下几点：

• 已导入os模块（默认项目会包含）
• 开发环境下DEBUG = True（Django仅在DEBUG模式下自动处理静态文件服务）
  完整配置示例：

import os

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

DEBUG = True

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

3. 修正模板中静态文件引用位置 #

你的模板将<link>直接写在{% extends %}后，若base.html包含head块，需将CSS引用放入对应块内才能正确渲染：
假设base.html结构如下：

<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}{% endblock %}</title>
    {% block extra_css %}{% endblock %}
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

子模板需修改为：

{% extends 'base.html' %}
{% load static %}

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

{% block content %}
    <div class="home">
        home
    </div>
{% endblock %}

4. 重启开发服务器 #

修改配置或模板后，必须重启python manage.py runserver，否则新配置不会生效。

5. 通过浏览器工具排查问题 #

打开浏览器开发者工具（F12），切换到「网络」标签页刷新页面：

• 若main.css请求返回404：检查STATICFILES_DIRS配置与文件实际位置是否匹配
• 若返回403：检查静态文件及目录的可读权限

6. 手动验证静态文件路径 #

在浏览器地址栏直接访问http://localhost:8000/static/main.css（端口对应你的开发服务器端口）：

• 能看到CSS内容：静态文件服务正常，问题出在模板引用
• 无法访问：静态文件配置或文件位置存在问题

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