Tệp tĩnh là CSS, JavaScript, hình ảnh của giao diện. Bài này cấu hình static, dùng thẻ {% static %}, gom tệp bằng collectstatic và phục vụ khi triển khai bằng WhiteNoise.
Bạn sẽ học được
- Thư mục static trong app và toàn cục
- Thẻ {% load static %}
- collectstatic
- Cài WhiteNoise
Cơ sở lý thuyết
Django phân biệt hai loại tệp không phải mã:
| Loại | Ý nghĩa | Cấu hình |
|---|---|---|
| Static (tĩnh) | CSS, JavaScript, ảnh giao diện do lập trình viên tạo, đi kèm mã nguồn | STATIC_URL, STATICFILES_DIRS, STATIC_ROOT |
| Media | Tệp do người dùng tải lên (ảnh đại diện, tài liệu) | MEDIA_URL, MEDIA_ROOT |
- Khi phát triển (DEBUG=True), runserver tự phục vụ tệp tĩnh. Khi triển khai, collectstatic gom tệp tĩnh từ mọi app vào STATIC_ROOT để Nginx hoặc WhiteNoise phục vụ – nhanh hơn nhiều so với để Python xử lý.
- ManifestStaticFilesStorage thêm mã băm vào tên tệp (site.4f2a1c.css) để trình duyệt lưu đệm lâu dài nhưng vẫn nhận bản mới khi tệp thay đổi.
- Thẻ {% static %} tạo đường dẫn đúng theo cấu hình, không viết cứng.
- Tệp tải lên là dữ liệu không tin cậy: kiểm tra phần mở rộng, kích thước; không bao giờ cho chạy tệp tải lên như mã.
Đặt tệp tĩnh
members/static/members/style.css
static/global.css # thư mục chung cạnh manage.py
# settings.py
STATIC_URL = "static/"
STATICFILES_DIRS = [BASE_DIR / "static"]
STATIC_ROOT = BASE_DIR / "productionfiles"Dùng trong template
{% load static %}
<link rel="stylesheet" href="/{% static 'global.css' %}">
<img src="/{% static 'members/logo.png' %}" alt="Logo">Khi triển khai
pip install whitenoise
# settings.py, đặt ngay sau SecurityMiddleware
MIDDLEWARE = [
"django.middleware.security.SecurityMiddleware",
"whitenoise.middleware.WhiteNoiseMiddleware",
# ...
]
python manage.py collectstaticỨng dụng thực tế
Bài toán: sinh viên nộp báo cáo đồ án dạng PDF tối đa 10 MB; tệp được lưu theo năm học, phục vụ an toàn; giao diện dùng CSS/JS qua WhiteNoise khi triển khai:
# settings.py
STATIC_URL = "static/"
STATICFILES_DIRS = [BASE_DIR / "static"]
STATIC_ROOT = BASE_DIR / "staticfiles"
MEDIA_URL = "media/"
MEDIA_ROOT = BASE_DIR / "media"
MIDDLEWARE.insert(1, "whitenoise.middleware.WhiteNoiseMiddleware")
STORAGES = {"default": {"BACKEND": "django.core.files.storage.FileSystemStorage"},
"staticfiles": {"BACKEND": "whitenoise.storage.CompressedManifestStaticFilesStorage"}}# models.py
from django.core.validators import FileExtensionValidator
from django.core.exceptions import ValidationError
def toi_da_10mb(f):
if f.size > 10 * 1024 * 1024: raise ValidationError("Tệp tối đa 10 MB")
class BaoCao(models.Model):
do_an = models.OneToOneField(DoAn, on_delete=models.CASCADE)
tep = models.FileField(upload_to="bao_cao/%Y/",
validators=[FileExtensionValidator(["pdf"]), toi_da_10mb])
# Form có tệp: <form method="post" enctype="multipart/form-data"> và DoAnForm(request.POST, request.FILES)python manage.py collectstatic --noinputLưu ý
Khi DEBUG = False, Django không tự phục vụ tệp tĩnh; cần WhiteNoise hoặc máy chủ web (Nginx). Ảnh người dùng tải lên (media) cấu hình riêng bằng MEDIA_URL, MEDIA_ROOT.
Thực hành
- Tạo global.css và áp dụng cho master.html.
- Thêm Bootstrap 5 hoặc Tailwind cho giao diện.
- Đặt DEBUG = False, cài WhiteNoise và kiểm tra CSS vẫn hiển thị.
Tóm tắt bài học
- Tệp tĩnh đặt trong static/.
- {% static %} tạo đường dẫn đúng.
- WhiteNoise + collectstatic khi triển khai.

