Django配置本地静态资源（CSS/JS）完整指南

Chloe

发布时间：2026-10-13 | 6人浏览过

原创

本文详细讲解在Django项目中如何正确配置并调用本地的CSS和JavaScript文件。通过创建static目录、修改settings.py中的STATICFILES_DIRS以及在前端HTML中正确引用路径，解决静态资源加载问题。

Django静态资源配置概述

本文旨在详细说明如何在Django框架中有效使用本地的CSS和JavaScript文件，并通过具体的示例代码进行演示，为读者的学习或工作提供具有实际价值的参考。

网络上关于Django配置本地静态资源的文章众多，但许多内容表述不够清晰或存在误导。

经过实际验证，以下方法确实可行，特此记录以便后续查阅。

创建static目录与文件结构

首先，在与manage.py文件相同的层级目录下创建一个名为static的文件夹，并将所需的css、js以及image等文件或子文件夹放入其中。

以下是我的项目目录结构示意：


➜ FileService git:(master) ✗ tree
.
├── 2kill_port.sh
├── FileService
│  ├── __init__.py
│  ├── __pycache__
│  │  ├── __init__.cpython-37.pyc
│  │  ├── settings.cpython-37.pyc
│  │  ├── urls.cpython-37.pyc
│  │  └── wsgi.cpython-37.pyc
│  ├── settings.py
│  ├── urls.py
│  └── wsgi.py
├── db.sqlite3
├── en_bg.jpg
├── fileoperation
│  ├── __init__.py
│  ├── __pycache__
│  │  ├── __init__.cpython-37.pyc
│  │  ├── admin.cpython-37.pyc
│  │  ├── models.cpython-37.pyc
│  │  └── views.cpython-37.pyc
│  ├── admin.py
│  ├── apps.py
│  ├── migrations
│  │  ├── __init__.py
│  │  └── __pycache__
│  │    └── __init__.cpython-37.pyc
│  ├── models.py
│  ├── templates
│  │  ├── bg_homg.html
│  │  └── home.html
│  └── views.py
├── files
│  ├── 11.log
│  ├── 22.log
│  ├── 44.log
│  ├── th.jpeg
│  ├── �\217�\225快�\205�\ 2020-01-08\ �\213�\215\2101.50.03.png
│  └── �\235�\231��\212��\224\200�\207��\201.pdf
├── kill_port.sh
├── manage.py
└── static
  ├── images
  │  └── en_bg.jpg
  └── style
    └── style.css

修改settings.py配置

接下来，只需在FileService/settings.py配置文件的末尾添加以下代码即可完成设置：


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

HTML中引入静态文件

最后，在需要使用的HTML文件中，通过以下方式引入静态资源：


<head>
  <link rel="stylesheet" type="text/css" href="../static/style/style.css" rel="external nofollow" />
  <meta charset="UTF-8">
  <title>文件传输</title>
</head>

以上内容即为Django配置本地静态文件的完整流程，希望能为各位的学习带来帮助，同时也欢迎大家继续支持本站。