Django静态文件使用

Django静态文件使用

静态文件基础概念

• 静态文件定义（CSS、JavaScript、图片等）
• Django中静态文件的作用
• 开发环境与生产环境的区别

配置静态文件

• STATIC_URL 的作用与设置
• STATICFILES_DIRS 的作用与设置
• STATIC_ROOT 的作用与设置
• 示例代码配置

模板中引用静态文件

• {% static %} 模板标签的使用
• 引用CSS文件的示例
• 引用JavaScript文件的示例
• 引用图片文件的示例

收集静态文件

• collectstatic 命令的作用
• 运行命令的步骤
• 生产环境中的部署注意事项

静态文件服务器

• Django开发服务器的局限性
• 使用Nginx或Apache托管静态文件
• 配置示例代码

缓存与版本控制

• 静态文件缓存策略
• 使用ManifestStaticFilesStorage进行版本控制
• 示例配置

常见问题与解决方案

• 静态文件404错误的排查方法
• 开发环境与生产环境的配置差异
• 性能优化建议

静态文件配置方法

在Django项目中配置静态文件需要完成以下几个步骤：

settings.py配置

在项目中的settings.py文件中添加或修改以下配置项：

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

项目结构创建

在项目根目录下创建static文件夹，用于存放静态文件（CSS、JS、图片等）。典型结构如下：

project/
    ├── static/
    │   ├── css/
    │   ├── js/
    │   └── images/
    ├── templates/
    └── manage.py

模板中引用静态文件

在HTML模板文件顶部添加以下代码加载静态文件标签：

{% load static %}

然后使用以下方式引用静态文件：

<link rel="stylesheet" href="{% static 'css/style.css' %}">
<script src="{% static 'js/app.js' %}"></script>
<img src="{% static 'images/logo.png' %}" alt="Logo">

开发服务器配置

在开发环境中，Django会自动处理静态文件。确保DEBUG = True，并运行python manage.py runserver即可。

生产环境部署

对于生产环境，需要运行以下命令收集静态文件：

python manage.py collectstatic

配置Web服务器（如Nginx或Apache）来直接提供静态文件服务。Nginx示例配置：

location /static/ {
    alias /path/to/your/project/staticfiles/;
    expires 30d;
}

媒体文件配置（可选）

如果需要处理用户上传的文件，还需配置媒体文件：

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

并在项目URL配置中添加：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ...其他URL配置...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)