Django 实战案例 讲解 values_list 的用法。
values_list("field", flat=True)→ 获取单字段的一维列表。values_list("f1", "f2")→ 获取多个字段，返回元组。- 搭配
filter/distinct/in/ 外键查询 非常高效。 - 适合用于 导出数据 或 二次查询，因为它比取完整对象要更轻量（不会加载所有字段和对象方法）。
1. 定义模型
假设我们有一个简单的 博客系统，有两个模型：Author 和 Article。
# blog/models.py
from django.db import models
class Author(models.Model):
name = models.CharField(max_length=50)
email = models.EmailField(unique=True)
def __str__(self):
return self.name
class Article(models.Model):
title = models.CharField(max_length=100)
content = models.TextField()
author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name="articles")
created_at = models.DateTimeField(auto_now_add=True)
def __str__(self):
return self.title
2. 插入一些测试数据
# 创建作者
a1 = Author.objects.create(name="Alice", email="alice@example.com")
a2 = Author.objects.create(name="Bob", email="bob@example.com")
# 创建文章
Article.objects.create(title="Django ORM 入门", content="....", author=a1)
Article.objects.create(title="Django QuerySet 高级用法", content="....", author=a1)
Article.objects.create(title="数据库优化技巧", content="....", author=a2)
3. values_list 基本用法
3.1 获取某个字段的列表
# 获取所有文章的标题列表
titles = Article.objects.values_list("title", flat=True)
print(list(titles))
# 结果: ['Django ORM 入门', 'Django QuerySet 高级用法', '数据库优化技巧']
👉 flat=True 表示返回单个字段时，结果是一个一维列表，而不是元组。
3.2 获取多个字段
# 获取文章标题和作者 ID
articles = Article.objects.values_list("title", "author_id")
print(list(articles))
# 结果: [('Django ORM 入门', 1), ('Django QuerySet 高级用法', 1), ('数据库优化技巧', 2)]
👉 当有多个字段时，结果是一个元组列表。
3.3 搭配 distinct 去重
# 获取所有作者 ID，去重
authors = Article.objects.values_list("author_id", flat=True).distinct()
print(list(authors))
# 结果: [1, 2]
3.4 搭配 filter 使用
# 获取 Alice 写的文章标题
alice_titles = Article.objects.filter(author__name="Alice").values_list("title", flat=True)
print(list(alice_titles))
# 结果: ['Django ORM 入门', 'Django QuerySet 高级用法']
3.5 用于外键关联
# 获取所有文章的标题和作者名字
articles = Article.objects.values_list("title", "author__name")
print(list(articles))
# 结果: [('Django ORM 入门', 'Alice'), ('Django QuerySet 高级用法', 'Alice'), ('数据库优化技巧', 'Bob')]
👉 注意这里 author__name 直接取了外键对象的字段。
4. 实际应用场景
4.1 批量取 ID 用于二次查询
# 获取 Alice 的文章 ID 列表
article_ids = Article.objects.filter(author__name="Alice").values_list("id", flat=True)
# 用这些 ID 去做其他操作，比如批量删除
Article.objects.filter(id__in=article_ids).delete()
4.2 导出数据（比直接取对象更高效）
# 导出文章标题和作者邮箱，直接生成 CSV
rows = Article.objects.values_list("title", "author__email")
import csv
with open("articles.csv", "w", newline="") as f:
writer = csv.writer(f)
writer.writerow(["标题", "作者邮箱"])
writer.writerows(rows)
👉 values_list 会直接返回元组，正好适合写入 CSV/Excel。