Django高效查询:values_list实战详解

Django 实战案例 讲解 values_list 的用法。

  • values_list("field", flat=True) → 获取单字段的一维列表。
  • values_list("f1", "f2") → 获取多个字段,返回元组。
  • 搭配 filter / distinct / in / 外键查询 非常高效。
  • 适合用于 导出数据 或 二次查询,因为它比取完整对象要更轻量(不会加载所有字段和对象方法)。

1. 定义模型

假设我们有一个简单的 博客系统 ,有两个模型:Author 和 Article。

python 复制代码
# 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. 插入一些测试数据

python 复制代码
# 创建作者
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 获取某个字段的列表

python 复制代码
# 获取所有文章的标题列表
titles = Article.objects.values_list("title", flat=True)
print(list(titles))
# 结果: ['Django ORM 入门', 'Django QuerySet 高级用法', '数据库优化技巧']

👉 flat=True 表示返回单个字段时,结果是一个一维列表,而不是元组。


3.2 获取多个字段

python 复制代码
# 获取文章标题和作者 ID
articles = Article.objects.values_list("title", "author_id")
print(list(articles))
# 结果: [('Django ORM 入门', 1), ('Django QuerySet 高级用法', 1), ('数据库优化技巧', 2)]

👉 当有多个字段时,结果是一个元组列表。


3.3 搭配 distinct 去重

python 复制代码
# 获取所有作者 ID,去重
authors = Article.objects.values_list("author_id", flat=True).distinct()
print(list(authors))
# 结果: [1, 2]

3.4 搭配 filter 使用

python 复制代码
# 获取 Alice 写的文章标题
alice_titles = Article.objects.filter(author__name="Alice").values_list("title", flat=True)
print(list(alice_titles))
# 结果: ['Django ORM 入门', 'Django QuerySet 高级用法']

3.5 用于外键关联

python 复制代码
# 获取所有文章的标题和作者名字
articles = Article.objects.values_list("title", "author__name")
print(list(articles))
# 结果: [('Django ORM 入门', 'Alice'), ('Django QuerySet 高级用法', 'Alice'), ('数据库优化技巧', 'Bob')]

👉 注意这里 author__name 直接取了外键对象的字段。


4. 实际应用场景

4.1 批量取 ID 用于二次查询

python 复制代码
# 获取 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 导出数据(比直接取对象更高效)

python 复制代码
# 导出文章标题和作者邮箱,直接生成 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。

相关推荐
承渊政道28 分钟前
【Python编程—从入门到实践】(设置样式并部署:给Django网站换新装,把学习笔记发布到互联网)
python·学习·pycharm·django
wuyk55520 小时前
Spider-第10讲-SQLite持久化与去重
数据库·爬虫·sqlite
FYKJ_20101 天前
springboot同人周边订单管理系统48955-计算机毕业设计、课程设计
java·javascript·vue.js·spring boot·django·php·课程设计
yuyuxun12 天前
协同过滤的校园二手物品智能推荐系统的设计与实现 毕业设计-附源码40082
javascript·vue.js·spring boot·python·数据分析·django·课程设计
2601_967987372 天前
Sqlite参考手册
数据库·python·sqlite·api·教程
treasure1403 天前
【复古】浅尝Django前后端不分离
前端·css·python·django·bootstrap·html·web
xiaoye-duck3 天前
《C++ 项目:手写大模型接入 SDK》DataManager数据管理模块:SQLite持久化存储
开发语言·数据库·c++·sqlite
ServBay4 天前
从 Val Town 停服看,代码能下载不代表项目能搬家
后端·sqlite
wo_jack4 天前
C++ 入门笔记(十七):list 入门 —— 为什么 list 不能 sort?
数据结构·c++·面试·stl·list
FungLeo5 天前
成为全栈·基础补充·数据库迁移与事务:数据结构怎样安全演进
mysql·postgresql·sqlite·数据一致性·数据库事务·数据库迁移·成为全栈