Django 静态文件配置实战指南

静态文件（如 CSS、JavaScript、图片等）是 Django 项目中构建用户界面的重要组成部分。然而，静态文件的配置问题常常导致开发和生产环境中的 404 Not Found 错误。本文将详细介绍如何正确配置 Django 静态文件，结合最佳实践，帮助你解决常见的静态文件问题，并确保项目在不同环境中正常运行。

---

^{_{© ivwdcwso (ID: u012172506)}}

1. 静态文件的基本概念

1.1 什么是静态文件？

静态文件是指不需要动态生成的文件，例如：

• CSS 文件（.css）
• JavaScript 文件（.js）
• 图片文件（.png, .jpg, .svg 等）
• 字体文件（.woff, .ttf 等）

1.2 Django 中的静态文件配置

Django 通过以下配置项管理静态文件：

• STATIC_URL：静态文件的 URL 前缀，通常为 /static/。
• STATIC_ROOT：静态文件的存储路径，用于生产环境中收集静态文件。
• STATICFILES_DIRS：开发环境中，Django 会从这些目录中查找静态文件。

---

^{_{© ivwdcwso (ID: u012172506)}}

2. 静态文件的配置详解

2.1 开发环境中的静态文件配置

在开发环境中，Django 会自动提供静态文件服务。以下是开发环境中的配置步骤：

2.1.1 启用静态文件服务

在 settings.py 中，确保以下配置正确：

# settings.py

DEBUG = True  # 启用调试模式

INSTALLED_APPS = [
    ...
    'django.contrib.staticfiles',  # 启用静态文件服务
    ...
]

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

# 开发环境中，静态文件的查找路径
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),