本地运行Django时CSS样式无法加载的问题求助

直接打开HTML文件时样式正常，但Django服务器下报错，是因为Django有一套专门的静态文件管理机制，不能像本地静态文件那样直接引用。按以下步骤修复：

1. 规范静态文件目录结构 #

Django要求静态文件放在app下的static子目录（或项目根目录的static目录），推荐给每个app的静态文件加一层子目录避免重名冲突，比如：

你的app目录/
    static/
        你的app名称/
            style.css
    templates/
        你的HTML文件.html

2. 确认settings.py配置 #

打开项目的settings.py，确保以下配置正确：

# 必须包含这个应用，Django才会处理静态文件
INSTALLED_APPS = [
    ...
    'django.contrib.staticfiles',
    ...
]

# 静态文件的URL前缀，默认即可
STATIC_URL = '/static/'

# 如果把静态文件放在项目根目录的static文件夹，需要添加这个配置（可选）
STATICFILES_DIRS = [
    BASE_DIR / "static",  # Django 3.1+版本写法，旧版本用os.path.join(BASE_DIR, 'static')
]

3. 在HTML模板中正确引用静态文件 #

不能直接写href="style.css"，要使用Django的模板标签生成正确路径：

• 先在HTML文件最顶部加载静态文件标签：

  {% load static %}
  

• 然后修改link标签为：

  <link rel="stylesheet" type="text/css" href="{% static '你的app名称/style.css' %}">
  

  如果静态文件放在项目根目录的static下，直接写{% static 'style.css' %}即可。

4. 生产环境额外步骤 #

如果是部署到生产环境，需要运行以下命令，把所有app的静态文件收集到统一的目录（开发环境无需执行）：

python manage.py collectstatic

排查小技巧 #

• 检查INSTALLED_APPS里是否有django.contrib.staticfiles，没有的话Django不会识别静态文件
• 核对静态文件的实际路径和模板中引用的路径是否一致，别写错文件夹或文件名
• 开发环境下，确保Django服务器是正常运行的，重启服务器试试

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