{{ article.title }}
{{ article.content|truncatewords:50 }}
{{ article.content|truncatewords:50 }}
暂无文章
{% endfor %} {% include "partials/pagination.html" %}关键技巧:
block.super:保留父模板内容(如标题追加前缀)truncatewords:50:自动截断长文本为 50 词摘要date:"Y-m-d":格式化日期为 ISO 标准onchange 实现标签筛选(无需 JS 框架)中间件处理请求/响应生命周期(如认证、缓存、日志)。信号(Signals)实现模型事件监听(如创建后发送通知):
# middleware.py
from django.utils.deprecation import MiddlewareMixin
class RequestTimingMiddleware(MiddlewareMixin):
def process_request(self, request):
request.start_time = time.time()
def process_response(self, request, response):
duration = time.time() - request.start_time
response["X-Response-Time"] = f"{duration:.3f}s"
return response
# signals.py
from django.db.models.signals import post_save
from django.dispatch import receiver
from django.core.mail import send_mail
from .models import Article
@receiver(post_save, sender=Article)
def send_article_notification(sender, instance, created, **kwargs):
if created and instance.status == "published":
send_mail(
subject=f"新文章发布:{instance.title}",
message=f"文章 '{instance.title}' 已发布,请查看。",
from_email="admin@xservx.com",
recipient_list=["editor@xservx.com"],
fail_silently=True,
)
注意:信号需在 apps.py 的 ready() 方法中注册,避免循环导入问题。
本节提供完整项目开发流程,从环境搭建到基础功能实现,适合初学者快速上手。
步骤 1:安装 Python 与虚拟环境
python --version # 确保 Python ≥ 3.10
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
步骤 2:安装 Django 与依赖
pip install django==4.2.16 psycopg2-binary redis celery[redis]
pip freeze > requirements/base.txt
步骤 3:创建项目与应用
django-admin startproject project .
python manage.py startapp blog
settings/base.py
INSTALLED_APPS = [
...
"blog",
]
DATABASES = {
"default": {
"ENGINE": "django.db.backends.postgresql",
"NAME": "django_db",
"USER": "django_user",
"PASSWORD": "password",
"HOST": "localhost",
"PORT": "5432",
}
}
STATIC_URL = "/static/"
STATICFILES_DIRS = [BASE_DIR / "static"]
STATIC_ROOT = BASE_DIR / "staticfiles"
MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR / "media"
models.py(同前文)
forms.py:表单验证
from django import forms
from .models import Article
class ArticleForm(forms.ModelForm):
class Meta:
model = Article
fields = ["title", "content", "tags", "status"]
widgets = {
"content": forms.Textarea(attrs={"rows": 10, "placeholder": "支持 Markdown"}),
"tags": forms.CheckboxSelectMultiple(),
}
views.py:增删改查
from django.views.generic import CreateView, UpdateView, DeleteView
from django.urls import reverse_lazy
class ArticleCreateView(CreateView):
model = Article
form_class = ArticleForm
template_name = "blog/article_form.html"
def form_valid(self, form):
form.instance.author = self.request.user
return super().form_valid(form)
def get_success_url(self):
return reverse_lazy("article_detail", kwargs={
"year": self.object.published_at.year,
"month": self.object.published_at.month,
"slug": self.object.slug,
})
class ArticleUpdateView(UpdateView):
model = Article
form_class = ArticleForm
template_name = "blog/article_form.html"
def get_queryset(self):
return super().get_queryset().filter(author=self.request.user)
def get_success_url(self):
return reverse_lazy("article_detail", kwargs={
"year": self.object.published_at.year,
"month": self.object.published_at.month,
"slug": self.object.slug,
})
class ArticleDeleteView(DeleteView):
model = Article
template_name = "blog/article_confirm_delete.html"
success_url = reverse_lazy("article_list")
def get_queryset(self):
return super().get_queryset().filter(author=self.request.user)
urls.py
urlpatterns = [
...
path("create/", ArticleCreateView.as_view(), name="article_create"),
path("<int:year>/<int:month>/<slug:slug>/edit/",
ArticleUpdateView.as_view(), name="article_edit"),
path("<int:year>/<int:month>/<slug:slug>/delete/",
ArticleDeleteView.as_view(), name="article_delete"),
]
article_form.html:支持标签多选与 Markdown 预览
{% raw %}{% extends "base.html" %}
{% block content %}
{{ object.pk|yesno:"编辑文章,新建文章" }}
{% endblock %}{% endraw %}
article_detail.html:展示文章 + 编辑/删除按钮
{% raw %}{% extends "base.html" %}
{% block content %}
{% endblock %}{% endraw %}
生产环境部署需考虑安全性、可扩展性与可维护性。本节提供基于 Docker 的标准化部署方案。
| 服务 | 镜像 | 端口 | 挂载卷 |
|---|---|---|---|
| 应用服务 | nginx:alpine | 80:80 | /etc/nginx/conf.d |
| WSGI 服务 | python:3.12-slim | 8000:8000 | /app |
| 数据库 | postgres:15-alpine | 5432:5432 | /var/lib/postgresql/data |
| 缓存 | redis:7-alpine | 6379:6379 | /data |
| 任务队列 | python:3.12-slim | - | /app |
version: "3.8"
services:
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: django_db
POSTGRES_USER: django_user
POSTGRES_PASSWORD: password
volumes:
- postgres_data:/var/lib/postgresql/data/
networks:
- django_net
redis:
image: redis:7-alpine
volumes:
- redis_data:/data
networks:
- django_net
app:
build: .
command: gunicorn project_name.wsgi:application --bind 0.0.0.0:8000
volumes:
- .:/app
- static_volume:/app/staticfiles
- media_volume:/app/media
environment:
- DJANGO_SETTINGS_MODULE=project_name.settings.production
- DB_HOST=db
- DB_NAME=django_db
- DB_USER=django_user
- DB_PASSWORD=password
- REDIS_HOST=redis
depends_on:
- db
- redis
networks:
- django_net
restart: unless-stopped
celery:
build: .
command: celery -A project_name worker -l info
volumes:
- .:/app
environment:
- DJANGO_SETTINGS_MODULE=project_name.settings.production
- DB_HOST=db
- REDIS_HOST=redis
depends_on:
- db
- redis
networks:
- django_net
restart: unless-stopped
nginx:
image: nginx:alpine
ports:
- "80:80"
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
- static_volume:/app/staticfiles
- media_volume:/app/media
depends_on:
- app
networks:
- django_net
restart: unless-stopped
volumes:
postgres_data:
redis_data:
static_volume:
media_volume:
networks:
django_net:
# Dockerfile
FROM python:3.12-slim
ENV PYTHONDONTWRITEBYTECODE=1 \
PYTHONUNBUFFERED=1 \
PIP_NO_CACHE_DIR=off \
PIP_DISABLE_PIP_VERSION_CHECK=on \
PIP_DEFAULT_TIMEOUT=100 \
POETRY_VERSION=1.7.1
# 安装系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential \
libpq-dev \
libcairo2-dev \
libpango1.0-dev \
libgdk-pixbuf2.0-dev \
libffi-dev \
shared-mime-info \
&& rm -rf /var/lib/apt/lists/*
# 安装 Poetry
RUN pip install "poetry==${POETRY_VERSION}"
WORKDIR /app
# 复制依赖文件
COPY pyproject.toml poetry.lock ./
# 安装依赖(生产环境)
RUN poetry config virtualenvs.create false \
&& poetry install --no-dev --no-root
# 复制应用代码
COPY . .
# 收集静态文件
RUN python manage.py collectstatic --noinput
EXPOSE 8000
CMD ["gunicorn", "project_name.wsgi:application", "--bind", "0.0.0.0:8000"]
# nginx.conf
server {
listen 80;
server_name xservx.com www.xservx.com;
location / {
proxy_pass http://app:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /static/ {
alias /app/staticfiles/;
expires 30d;
add_header Cache-Control "public, immutable";
}
location /media/ {
alias /app/media/;
expires 7d;
add_header Cache-Control "public, immutable";
}
}
python manage.py migrate --noinput 避免交互式输入高并发场景下,需从数据库、缓存、前端、CDN 等多维度优化。
db_index=True 或 Meta.indexes)select_related、prefetch_related)django-db-conn-pool 复用数据库连接DATABASES['default']['RW_SPLIT'])| 缓存类型 | Django 支持 | 适用场景 | 配置示例 |
|---|---|---|---|
| 文件缓存 | ✓ | 单机开发环境 | BACKEND: 'django.core.cache.backends.filebased.FileBasedCache' |
| 内存缓存 | ✓ | 开发/测试环境 | BACKEND: 'django.core.cache.backends.locmem.LocMemCache' |
| Redis 缓存 | ✓(需插件) | 生产环境 | BACKEND: 'django_redis.cache.RedisCache' |
| 页面缓存 | ✓ | 静态内容 | @cache_page(60 * 15) |
| 片段缓存 | ✓ | 动态模块 | {% cache 500 "sidebar" %} |
gzip on;loading="lazy" 属性需求:支持多用户协作、评论系统、SEO 优化、多语言、富文本编辑器。
技术方案:
需求:商品管理、购物车、订单系统、支付集成、库存管理、促销活动。
技术方案:
需求:用户系统、关注/粉丝、动态流、消息通知、实时聊天。
技术方案:
cursor pagination 避免深度分页)基于全网搜索数据,整理高频问题并提供深度解答:
Django 更适合中大型项目:内置 ORM、认证、Admin 后台、表单验证等组件,减少重复开发,适合快速构建功能完整的产品。例如:内容管理系统、企业后台、电商平台。
Flask 更适合微服务与轻量应用:核心极简,通过插件扩展功能,适合 API 服务、小型 Web 应用、原型验证。例如:RESTful API、微服务网关、IoT 数据采集。
决策矩阵:
| 维度 | Django | Flask |
|---|---|---|
| 学习曲线 | 较陡(组件多) | 平缓(核心少) |
| 项目规模 | 中大型(5万+ 行代码) | 小型(<5万行) |
| 扩展性 | 插件丰富但耦合度高 | 插件松耦合,易定制 |
| 开发速度 | 快(开箱即用) | 较慢(需手写组件) |
| 性能 | 中等(WSGI 启动) | 较高(ASGI 支持更好) |
建议:初学者可从 Django 入手,掌握 Web 开发全貌;有特定需求(如微服务)时再考虑 Flask。
问题 1:静态文件 404
原因:生产环境未执行 collectstatic,或 Nginx 配置错误。
解决方案:
STATIC_ROOT 设置正确python manage.py collectstaticlocation /static/ { alias /path/to/staticfiles/; }问题 2:数据库连接失败
原因:Docker 网络隔离导致无法访问 localhost。
解决方案:
db)depends_on 正确声明依赖healthcheck)问题 3:环境变量未生效
原因:Docker 容器内未加载 .env 文件。
解决方案:
docker-compose 的 env_file 字段environment 中定义市场需求:根据 2025 年招聘数据,Python 开发岗位中 68% 要求 Django 知识,平均薪资 15K-25K/月(一线城市)。
核心竞争力:
职业路径:
初级开发者 → 中级工程师(3年经验) → 高级架构师(5年+)
或转向:全栈开发、DevOps 工程师、技术负责人
我们致力于提供高质量的 Django 技术支持与培训服务,欢迎联系:
提供以下服务:
暂无评论
{% endif %}