编辑“︁Django静态文件”︁（章节）

= Django静态文件 =

'''Django静态文件'''是指网站中不需要动态生成的文件，如CSS样式表、JavaScript脚本、图像、字体等。这些文件在请求时直接返回给客户端，不需要经过Django视图处理。合理管理静态文件对网站性能和开发效率至关重要。

== 静态文件基础 ==

=== 什么是静态文件？ ===
静态文件指那些内容固定不变、无需服务器端动态处理的文件，包括：
* 样式表（.css）
* 客户端脚本（.js）
* 图像（.png, .jpg, .svg等）
* 字体文件（.woff, .ttf等）
* 下载文档（.pdf, .docx等）

=== 与媒体文件的区别 ===
{| class="wikitable"
|-
! 静态文件 !! 媒体文件
|-
| 开发者创建，随代码发布 || 用户上传，运行时产生
|-
| 版本控制管理 || 通常不在版本控制中
|-
| 通过<code>collectstatic</code>收集 || 通过文件字段上传
|}

== 配置静态文件 ==

=== 基本设置 ===
在<code>settings.py</code>中配置：

<syntaxhighlight lang="python">
# 静态文件URL前缀
STATIC_URL = '/static/'

# 静态文件目录列表
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'myapp/static'),
]

# 收集静态文件的目标目录
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
</syntaxhighlight>

=== 目录结构示例 ===
<mermaid>
graph TD
    A[project_root] --> B[myapp/static/myapp]
    A --> C[another_app/static/another_app]
    B --> D[css/style.css]
    B --> E[js/script.js]
    B --> F[images/logo.png]
</mermaid>

== 开发环境使用 ==

=== 模板中引用静态文件 ===
首先加载static模板标签：

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

=== 开发服务器配置 ===
确保<code>DEBUG=True</code>时，Django会自动服务静态文件：

<syntaxhighlight lang="python">
# urls.py
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ...你的其他URL模式...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
</syntaxhighlight>

== 生产环境部署 ==

=== 收集静态文件 ===
运行以下命令将所有静态文件收集到<code>STATIC_ROOT</code>：

<syntaxhighlight lang="bash">
python manage.py collectstatic
</syntaxhighlight>

=== Web服务器配置示例 ===
'''Nginx配置示例'''：

<syntaxhighlight lang="nginx">
location /static/ {
    alias /path/to/your/staticfiles/;
    expires 30d;
    access_log off;
}
</syntaxhighlight>

'''Apache配置示例'''：

<syntaxhighlight lang="apache">
Alias /static/ "/path/to/your/staticfiles/"
<Directory "/path/to/your/staticfiles/">
    Require all granted
</Directory>
</syntaxhighlight>

== 高级主题 ==

=== 静态文件存储后端 ===
可以自定义存储后端，例如使用CDN或云存储：

<syntaxhighlight lang="python">
# settings.py
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
AWS_STORAGE_BUCKET_NAME = 'my-static-files'
AWS_S3_CUSTOM_DOMAIN = f'{AWS_STORAGE_BUCKET_NAME}.s3.amazonaws.com'
STATIC_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/'
</syntaxhighlight>

=== 文件版本控制 ===
防止浏览器缓存问题，添加文件哈希：

<syntaxhighlight lang="python">
# settings.py
STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'
</syntaxhighlight>

== 最佳实践 ==

1. '''按应用组织静态文件'''：每个应用的静态文件放在<code>app/static/app/</code>目录下
2. '''使用版本控制'''：避免缓存问题
3. '''开发生产分离'''：开发时使用Django服务，生产时使用Web服务器/CDN
4. '''启用压缩'''：使用Gzip/Brotli压缩静态文件
5. '''设置缓存头'''：静态文件应设置长期缓存

== 常见问题 ==

'''Q: 修改了静态文件但浏览器不更新？'''
A: 可能由于缓存，尝试：
* 强制刷新（Ctrl+F5）
* 使用<code>?v=1</code>参数
* 实现文件哈希版本控制

'''Q: <code>collectstatic</code>太慢？'''
A: 使用<code>--noinput</code>和<code>--clear</code>标志：

<syntaxhighlight lang="bash">
python manage.py collectstatic --noinput --clear
</syntaxhighlight>

== 实际案例 ==

=== 案例1：添加自定义字体 ===
1. 将字体文件放入<code>static/myapp/fonts/</code>
2. CSS中引用：

<syntaxhighlight lang="css">
@font-face {
    font-family: 'CustomFont';
    src: url('/static/myapp/fonts/custom-font.woff2') format('woff2');
}
</syntaxhighlight>

=== 案例2：使用Bootstrap ===
1. 下载Bootstrap到<code>static/myapp/vendor/bootstrap/</code>
2. 模板中引用：

<syntaxhighlight lang="django">
<link href="{% static 'myapp/vendor/bootstrap/css/bootstrap.min.css' %}" rel="stylesheet">
<script src="{% static 'myapp/vendor/bootstrap/js/bootstrap.bundle.min.js' %}"></script>
</syntaxhighlight>

== 数学表示（可选） ==
静态文件缓存效率可以用以下公式表示：

<math>
E = 1 - \frac{R}{T}
</math>

其中：
* <math>E</math> = 缓存效率
* <math>R</math> = 重复请求数
* <math>T</math> = 总请求数

== 总结 ==
Django静态文件系统提供了强大的工具来管理网站资产。通过合理配置和遵循最佳实践，可以显著提高网站性能。记住：
* 开发时使用Django内置服务
* 生产时使用专用Web服务器/CDN
* 实施版本控制和缓存策略
* 保持组织结构清晰

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django模板系统]]