在Python Django中引入CSS与Bootstrap及自定义CSS失效问题排查

下面是针对Bootstrap生效但自定义CSS失效问题的具体排查步骤：

一、修正静态文件引用方式 #

你模板里用的相对路径css/style.css不符合Django的静态文件规范，必须用Django提供的静态标签来引用：

• 先在模板最顶部加上加载静态标签：{% load static %}
• 把自定义CSS的引用改成：<link rel="stylesheet" href="{% static 'css/style.css' %}">

二、核对settings.py的静态文件配置 #

打开项目的settings.py，检查以下关键配置是否正确：

# 静态文件的URL访问前缀
STATIC_URL = '/static/'

# 指定开发环境下静态文件的存放目录（要和你的文件路径对应）
STATICFILES_DIRS = [
    BASE_DIR / "static",  # 假设你的css文件夹放在项目根目录的static文件夹里
]

# 生产环境用来收集所有静态文件的目录（开发阶段可暂时忽略）
STATIC_ROOT = BASE_DIR / 'staticfiles'

同时确认你的style.css确实放在项目根目录/static/css/这个路径下，文件位置不能错。

三、强制清除浏览器缓存 #

浏览器经常会缓存旧的CSS文件，导致新样式不生效。按Ctrl+Shift+R（Windows）或Cmd+Shift+R（Mac）强制刷新页面，再看样式是否生效。

四、提升自定义CSS的优先级 #

如果路径都没问题但样式还是被覆盖，那就是你的CSS选择器优先级不如Bootstrap的高。比如：

• 原来的样式：button { color: red; }
• 可以改成更具体的选择器：div.content-area button.custom-btn { color: red; }
• 或者临时用!important（尽量少用，仅作调试）：.custom-btn { color: red !important; }

五、确认开发服务器的静态文件服务 #

确保你用的是Django自带的开发服务器（执行python manage.py runserver启动），它会自动处理静态文件的访问。如果用第三方服务器，需要额外配置静态文件的映射路径。

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