如何在Django项目中本地引入bootstrap.min.css自定义DRF可浏览API

步骤1：创建正确的静态文件目录结构 #

Django的静态资源（CSS、JS、图片等）需要放在app下的static目录里，按规则分类存放。在你的snippets app下创建如下结构：

snippets/
└── static/
    └── rest_framework/
        └── css/
            └── bootstrap.min.css

把下载好的bootstrap.min.css放到这个css文件夹里。

步骤2：确认静态文件基础配置 #

检查settings.py里是否有以下配置（默认Django已自带，若缺失则添加）：

# settings.py
STATIC_URL = '/static/'
# 生产环境需收集静态文件时可添加（开发环境暂不需要）
# STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

步骤3：修改api.html模板引用路径 #

在你的api.html里，使用Django的static模板标签加载本地CSS，替换原CDN链接：

{% extends "rest_framework/base.html" %}
<!-- 先加载static模板标签 -->
{% load static %}

{% block bootstrap_theme %}
    <link rel="stylesheet" href="{% static 'rest_framework/css/bootstrap.min.css' %}" type="text/css">
{% endblock %}

错误原因说明 #

• 若之前把CSS放到templates目录下，Django的模板目录仅用于存放HTML模板，不会处理静态资源请求，因此返回Not Found。
• 直接写相对路径无法被Django的静态文件路由解析，必须用static模板标签生成正确的URL，Django会自动映射到app下的static目录。

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