什么是 QuerySet，它们为什么是惰性的？

Question

Accepted Answer

**QuerySet** 将数据库行的集合表示为 Python 对象，您可以对其进行 filter、order 和 chain 操作。其定义特征是**惰性** — QuerySet 在创建时**不会**访问数据库；它只在实际需要数据时（evaluated）才执行查询。理解这一点是编写高效 Django 代码的关键。

## QuerySet 是惰性的 — 在 evaluation 之前不会访问数据库

```python
# NONE of these touch the database — they just build up the query
qs = Article.objects.all()                  # no query yet
qs = qs.filter(published=True)              # still no query — chaining is lazy
qs = qs.exclude(views=0).order_by("-created_at")   # still no query

# the database is hit ONLY when the QuerySet is EVALUATED:
for article in qs:        # ← NOW the query runs
    print(article.title)
```

构建和链式调用 QuerySet 的成本为零 — Django 组装 SQL 但延迟执行，直到您实际需要结果为止。这让您能够在单次数据库访问中高效地组合复杂查询。

## 什么会触发 evaluation（数据库访问）

```text
✓ Iterating:        for x in qs
✓ Slicing with step: qs[::2]  (plain slicing qs[:10] stays lazy, adds LIMIT)
✓ len(qs), list(qs), bool(qs)
✓ Calling a non-QuerySet method: .count(), .exists(), .first(), .get(), .aggregate()
```

## 为什么惰性很强大

```python
# build a query conditionally WITHOUT extra database trips
qs = Article.objects.all()
if search:
    qs = qs.filter(title__icontains=search)   # no DB hit
if category:
    qs = qs.filter(category=category)          # no DB hit
articles = qs[:20]                              # ONE query runs here, with LIMIT 20
```

惰性让您能够跨多行有条件地组成查询，然后执行一**次** — 高效且简洁。

## QuerySet 缓存

```python
qs = Article.objects.filter(published=True)
list(qs)     # query runs, results CACHED on the QuerySet
list(qs)     # uses the CACHE — no second query
# BUT a NEW queryset re-queries:
Article.objects.filter(published=True)   # a fresh queryset → new query
```

一旦 evaluated，QuerySet 会缓存其结果，所以重新迭代*同一个* QuerySet 不会重新查询。

## 惰性的陷阱

```python
# ⚠️ calling .count() then iterating runs TWO queries
if Article.objects.filter(published=True).count() > 0:   # query 1
    for a in Article.objects.filter(published=True):     # query 2 (new queryset!)
        ...
# ✅ better — evaluate once, reuse
qs = list(Article.objects.filter(published=True))
if qs: ...
```

## 为什么这很重要

理解 QuerySet 及其惰性是编写高效、正确的 Django 数据库代码的基础 — 它直接影响性能，并解释了让新手困惑的行为。

核心认识是 QuerySet **在 evaluation 之前不会访问数据库**，这很强大：您可以构建、filter、chain 和有条件地跨多行代码组合复杂查询，零数据库成本，然后在实际需要结果时在**单次访问**中执行一切。

这支持了简洁、高效的查询构造（例如，根据用户输入有条件地添加 filters，然后运行一个查询），否则需要笨拙的 SQL 字符串拼接。

精确了解**什么触发 evaluation**（迭代、`len()`、`list()`、`.count()`、`.exists()`、等等）以及结果在 evaluated QuerySet 上被**缓存**，对于避免常见性能陷阱至关重要 — 最值得注意的是不小心多次运行相同查询（例如调用 `.count()` 然后迭代一个新的 QuerySet，访问数据库两次）。

惰性是良好使用 Django ORM 的最重要概念之一，区分了编写高效数据库代码的开发者和那些无意中触发冗余查询的开发者，使其成为支撑 Django 中所有有效 ORM 使用和性能优化的核心知识。