1
浏览器（Client）  ──HTTP 请求──▶  服务器（Server）
2
                 ◀──HTTP 响应──

1
一个 HTTP 请求包含：
2
- 请求行：GET /index.html HTTP/1.1（方法 + 路径 + 协议版本）
3
- 请求头：Host、User-Agent、Cookie、Content-Type 等
4
- 请求体：POST/PUT 的数据（表单或 JSON）
5

6
一个 HTTP 响应包含：
7
- 状态行：HTTP/1.1 200 OK（协议 + 状态码 + 描述）
8
- 响应头：Content-Type、Content-Length、Set-Cookie 等
9
- 响应体：HTML/JSON/文件内容

1
2xx 成功：200 OK、201 Created、204 No Content
2
3xx 重定向：301 永久重定向、302 临时重定向、304 Not Modified（缓存）
3
4xx 客户端错误：400 请求错误、401 未认证、403 无权限、404 找不到
4
5xx 服务器错误：500 内部错误、502 网关错误、503 服务不可用

1
mysite/
2
├── manage.py              # 项目管理命令入口
3
├── mysite/                # 项目配置目录
4
│   ├── __init__.py
5
│   ├── settings.py        # 全局配置（数据库、应用、中间件）
6
│   ├── urls.py            # 根路由
7
│   ├── asgi.py            # ASGI 入口（异步）
8
│   └── wsgi.py            # WSGI 入口（同步）
9
└── blog/                  # 应用目录
10
    ├── __init__.py
11
    ├── admin.py           # Admin 后台注册
12
    ├── apps.py            # 应用配置
13
    ├── models.py          # 数据模型
14
    ├── views.py           # 视图
15
    ├── urls.py            # 应用路由（需自己创建）
16
    ├── tests.py           # 测试
17
    └── migrations/        # 数据库迁移记录

1
# blog/urls.py（应用级路由，需自己创建）
2
from django.urls import path
3
from . import views
4

5
app_name = "blog"      # 命名空间，用于反向解析
6

7
urlpatterns = [
8
    path("", views.index, name="index"),               # 访问 /blog/
9
    path("<int:post_id>/", views.detail, name="detail"), # 访问 /blog/1/
10
]

1
# mysite/urls.py（根路由，包含应用路由）
2
from django.contrib import admin
3
from django.urls import path, include
4

5
urlpatterns = [
6
    path("admin/", admin.site.urls),
7
    path("blog/", include("blog.urls")),   # 把 blog 应用的路由挂到 /blog/ 下
8
]

1
from blog.models import Post, Category
2

3
# 增（Create）
4
cat = Category.objects.create(name="技术")
5
post = Post(title="标题", content="内容", category=cat)
6
post.save()                                  # 或者 Post.objects.create(...)
7

8
# 查（Read）——返回 QuerySet（惰性，用到才查库）
9
Post.objects.all()                           # 全部
10
Post.objects.get(id=1)                       # 唯一一条（找不到抛异常）
11
Post.objects.filter(is_published=True)       # 条件过滤
12
Post.objects.exclude(is_published=False)     # 排除
13
Post.objects.filter(title__contains="Django") # 模糊查询（双下划线）
14
Post.objects.filter(views__gt=100)           # 大于
15
Post.objects.filter(category__name="技术")    # 跨关系查询
16
Post.objects.order_by("-views")[:10]         # 排序 + 切片（Top10）
17
Post.objects.first()                         # 第一条
18
Post.objects.count()                         # 计数
19

20
# 改（Update）
21
post = Post.objects.get(id=1)
22
post.views += 1
23
post.save()                                  # 保存整个对象
24
Post.objects.filter(id=1).update(views=99)   # 批量更新（更高效）
25

26
# 删（Delete）
27
post.delete()                                # 删单条
28
Post.objects.filter(is_published=False).delete()  # 批量删

1
__exact / __iexact   精确 / 忽略大小写
2
__contains           包含（LIKE %x%）
3
__startswith / __endswith  以...开头/结尾
4
__in                 在列表中
5
__gt / __gte         大于 / 大于等于
6
__lt / __lte         小于 / 小于等于
7
__range              范围（BETWEEN）
8
__isnull             是否为 NULL

1
# ❌ N+1 问题：查 N 篇文章，每篇访问 category 又查一次库（共 N+1 次）
2
for post in Post.objects.all():
3
    print(post.category.name)
4

5
# ✅ select_related：一次 JOIN 把外键对象一起查出来（多对一）
6
for post in Post.objects.select_related("category").all():
7
    print(post.category.name)
8

9
# ✅ prefetch_related：多对多/反向外键，两次查询后在内存组装
10
for post in Post.objects.prefetch_related("tags").all():
11
    print([t.name for t in post.tags.all()])

1
模板语法速记：
2
{{ 变量 }}        输出变量（自动 HTML 转义）
3
{% 标签 %}        逻辑标签（for/if/extends/block/url）
4
{# 注释 #}        注释
5
{{ post.title }}  访问属性/方法
6
{{ list|length }} 过滤器（管道）

1
{% load static %}                              <!-- 先加载 static 标签 -->
2
<img src="{% static 'images/logo.png' %}">
3
<link rel="stylesheet" href="{% static 'css/style.css' %}">

1
// 前端 fetch 请求
2
fetch('/blog/api/like/1/', {
3
    method: 'POST',
4
    headers: {
5
        'Content-Type': 'application/json',
6
        'X-CSRFToken': getCookie('csrftoken'),   // CSRF 令牌（见下）
7
    },
8
    body: JSON.stringify({}),
9
})
10
.then(resp => resp.json())
11
.then(data => console.log(data.views));
12

13
function getCookie(name) {
14
    const value = `; ${document.cookie}`;
15
    const parts = value.split(`; ${name}=`);
16
    if (parts.length === 2) return parts.pop().split(';').shift();
17
}

1
# 设置 Cookie（在响应对象上）
2
def set_cookie(request):
3
    response = HttpResponse("已设置 Cookie")
4
    response.set_cookie("username", "tom", max_age=3600)  # 1 小时过期
5
    return response
6

7
# 读取 Cookie
8
def get_cookie(request):
9
    username = request.COOKIES.get("username")
10
    return HttpResponse(f"你好，{username}")

1
# 写 Session
2
request.session["user_id"] = 123
3
request.session["cart"] = {"item1": 2}
4

5
# 读 Session
6
user_id = request.session.get("user_id")
7

8
# 删 Session
9
del request.session["user_id"]
10
request.session.flush()        # 清空当前会话

1
Cookie vs Session：
2
┌──────────┬──────────────────┬──────────────────┐
3
│          │ Cookie           │ Session          │
4
├──────────┼──────────────────┼──────────────────┤
5
│ 存储位置 │ 浏览器           │ 服务器           │
6
│ 安全性   │ 较低（用户可见） │ 较高             │
7
│ 容量     │ 约 4KB           │ 较大             │
8
│ 生命周期 │ 可设过期时间     │ 默认 2 周        │
9
│ 关联     │ SessionID 存 Cookie，服务器用 SessionID 找数据 │
10
└──────────┴──────────────────┴──────────────────┘

1
from django.contrib.auth import authenticate, login, logout
2
from django.contrib.auth.decorators import login_required
3

4
def user_login(request):
5
    if request.method == "POST":
6
        username = request.POST.get("username")
7
        password = request.POST.get("password")
8
        user = authenticate(request, username=username, password=password)
9
        if user is not None:
10
            login(request, user)              # 登录（写入 Session）
11
            return redirect("blog:index")
12
    return render(request, "login.html")
13

14
@login_required                               # 未登录自动跳登录页
15
def profile(request):
16
    return HttpResponse(f"你好，{request.user.username}")
17

18
def user_logout(request):
19
    logout(request)                           # 退出
20
    return redirect("blog:index")

1
# 导出 Excel（用 xlwt）
2
import xlwt
3
from django.http import HttpResponse
4

5
def export_excel(request):
6
    response = HttpResponse(content_type="application/vnd.ms-excel")
7
    response["Content-Disposition"] = 'attachment; filename="posts.xls"'
8

9
    wb = xlwt.Workbook(encoding="utf-8")
10
    ws = wb.add_sheet("文章")
11
    ws.write(0, 0, "标题")           # 表头
12
    ws.write(0, 1, "阅读量")
13
    row = 1
14
    for post in Post.objects.all():
15
        ws.write(row, 0, post.title)
16
        ws.write(row, 1, post.views)
17
        row += 1
18
    wb.save(response)               # 直接写入响应流
19
    return response
20

21
# 导出 PDF 用 reportlab；前端图表用 ECharts（后端提供 JSON 数据接口）

1
# settings.py 配置日志
2
LOGGING = {
3
    "version": 1,
4
    "handlers": {
5
        "file": {
6
            "level": "WARNING",
7
            "class": "logging.FileHandler",
8
            "filename": "debug.log",
9
        },
10
    },
11
    "loggers": {
12
        "django": {"handlers": ["file"], "level": "WARNING"},
13
    },
14
}

1
# 视图中记录日志
2
import logging
3
logger = logging.getLogger(__name__)
4

5
def index(request):
6
    logger.info("访问首页")
7
    logger.warning("这条会写入文件")
8
    return HttpResponse("OK")

1
日志级别（由低到高）：DEBUG < INFO < WARNING < ERROR < CRITICAL
2
设置某级别后，只记录该级别及以上的日志。

1
# settings.py 注册（顺序很重要）
2
MIDDLEWARE = [
3
    "django.middleware.security.SecurityMiddleware",
4
    "blog.middleware.RequestTimeMiddleware",   # 加自己的
5
    # ...
6
]