Django membezakan dua jenis fail: fail statik (aset yang merupakan sebahagian daripada aplikasi anda — CSS, JavaScript, imej yang anda hantar) dan fail media (fail yang dimuat naik oleh pengguna semasa runtime — gambar profil, dokumen). Mereka dikendalikan secara berbeza kerana sumber dan kitaran hayat mereka berbeza secara mendasar.
STATIC_URL =
STATICFILES_DIRS = [BASE_DIR / ]
STATIC_ROOT = BASE_DIR /
<!-- in templates -->
{% load static %}
<link rel="stylesheet" href="{% static 'css/style.css' %}">
<img src="{% static 'images/logo.png' %}">
Fail statik ialah sebahagian daripada pangkalan kod anda — CSS, JS, fon, imej reka bentuk. Ia dikawal-versi, sama untuk semua pengguna, dan disajikan daripada direktori statik projek anda.
python manage.py collectstatic
# gathers ALL static files (from your apps and STATICFILES_DIRS) into STATIC_ROOT,
# so a web server / CDN can serve them efficiently in production
Dalam pengeluaran, collectstatic menyatukan fail statik daripada semua aplikasi ke dalam satu direktori (STATIC_ROOT) untuk pelayan web atau CDN menyajikannya — Django tidak menyajikannya sendiri dalam pengeluaran.
# settings.py
MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR / "media" # where UPLOADED files are stored
# a model with an uploadable file
class Profile(models.Model):
avatar = models.ImageField(upload_to="avatars/") # stored under MEDIA_ROOT/avatars/
document = models.FileField(upload_to="docs/")
profile.avatar.url # the URL to access the uploaded file
Fail media dimuat naik oleh pengguna semasa runtime melalui FileField/ImageField. Ia dinamik, BUKAN dalam kawalan versi, dan berkembang dari masa ke masa apabila pengguna memuat naik kandungan.
Static files Media files
Source part of your code uploaded by users at runtime
Version control YES (committed) NO (user-generated, .gitignored)
Lifecycle fixed (changes with code) dynamic (grows continuously)
Examples CSS, JS, logos, fonts avatars, uploaded documents, photos
Settings STATIC_URL/ROOT/DIRS MEDIA_URL/ROOT
Production collectstatic + CDN/server stored on disk/cloud (S3), served carefully
✓ Static → serve via the web server (nginx) or a CDN (cached, fast)
✓ Media → store on cloud storage (S3) for scalability/persistence; in multi-server
setups, local disk doesn't work (files must be shared) → use S3/object storage
✓ Security → VALIDATE uploaded files (type, size); be careful serving user uploads
(a user could upload malicious content)
Memahami perbezaan statik-lawan-media adalah penting untuk membina dengan betul dan men-deploy aplikasi Django dengan sewajarnya, kerana kedua-dua jenis fail mempunyai sumber, kitaran hayat, dan keperluan pengendalian yang berbeza secara mendasar. Fail statik (CSS, JavaScript, imej, fon aplikasi anda sendiri) ialah sebahagian daripada pangkalan kod, dikawal-versi, dan sama untuk semua orang — dirujuk melalui {% static %} dan disatukan dengan collectstatic untuk penyajian pengeluaran oleh pelayan web atau CDN. Fail media (muat naik pengguna melalui FileField/ImageField) ialah kandungan dinamik yang dijana-pengguna yang dicipta semasa runtime, BUKAN dalam kawalan versi, dan berkembang secara berterusan.
Mengelirukannya atau salah mengkonfigurasi tetapannya (STATIC_* lawan MEDIA_*) ialah punca biasa masalah "CSS saya tidak dimuatkan" atau "muat naik tidak berfungsi", terutamanya dalam pengeluaran di mana Django tidak menyajikan fail statik sendiri (memerlukan collectstatic dan pelayan/CDN yang sesuai).
Perbezaan ini juga mempunyai implikasi pengeluaran dan keselamatan yang penting: fail media dalam deployment berbilang pelayan tidak boleh bergantung pada cakera tempatan (ia mesti menggunakan storan awan yang dikongsi seperti S3), dan muat naik pengguna memerlukan pengesahan (jenis fail, saiz) serta penyajian yang teliti untuk mengelakkan risiko keselamatan daripada kandungan berniat jahat.
Mengetahui cara mengkonfigurasi dan mengendalikan kedua-dua jenis, peranan collectstatic, dan pertimbangan pengeluaran (CDN untuk statik, storan awan untuk media, keselamatan muat naik) ialah pengetahuan praktikal yang kerap diperlukan untuk membina dan men-deploy aplikasi Django sebenar dengan betul — satu batu penghalang biasa yang diselesaikan oleh pemahaman ini.