Django中get()与filter()的区别及常见错误
更新时间：2025年11月02日 15:02:27 作者：言之。
Django中get()和filter()是数据查询的核心方法,本文就来介绍一下Django中get()与filter()的区别及常见错误,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
在 Django 中，get() 和 filter() 是 QuerySet API 中用于检索数据的两个核心方法，它们的功能和使用场景有明显区别。以下是详细对比：
1. 核心区别
| 特性 | get() | filter() |
|---|---|---|
| 返回值 | 单个对象（模型实例） | 查询集（QuerySet，可迭代） |
| 数量限制 | 必须精确匹配1个对象 | 可以匹配0个、1个或多个对象 |
| 对象不存在时 | 抛出 DoesNotExist 异常 | 返回空查询集（不报错） |
| 多对象匹配时 | 抛出 MultipleObjectsReturned 异常 | 返回包含多个对象的查询集 |
| 链式调用 | 不支持（返回的是模型实例） | 支持（可继续添加过滤条件） |
2. 语法与示例
get()的用法
# 获取 ID 为 1 的书（必须存在且唯一）
book = Book.objects.get(id=1)
# 等价的手动异常处理
try:
book = Book.objects.get(id=1)
except Book.DoesNotExist:
# 处理不存在的情况
pass
except Book.MultipleObjectsReturned:
# 处理多对象匹配的情况
pass
filter()的用法
# 获取所有已发布的书（可能有0本或多本） books = Book.objects.filter(status='published') # 链式过滤：获取已发布且价格大于 50 的书 books = Book.objects.filter(status='published').filter(price__gt=50) # 等价的单语句写法 books = Book.objects.filter(status='published', price__gt=50) # 获取第一本书或 None（推荐替代 get() 的安全写法） first_book = books.first() # 等价于 books[0] if books else None
3. 性能对比
get()：直接查询单条记录，生成的 SQL 类似SELECT ... WHERE ... LIMIT 1，理论上更高效。filter().first()：生成的 SQL 是SELECT ... WHERE ... LIMIT 1，与get()几乎相同，但多了一步 Python 对象转换，性能损耗可忽略不计。
注意：在查询条件唯一（如主键查询）时，两者性能接近；但 filter().first() 更安全。
4. 适用场景
推荐使用get()的场景
- 查询条件唯一（如通过主键或唯一键查询）。
- 对象必须存在，否则视为程序错误（如配置项、固定ID的系统数据）。
- 示例：
user = User.objects.get(username='admin') # 管理员用户必须存在
推荐使用filter()的场景
- 查询条件不唯一（如按类别筛选商品）。
- 结果可能为空（如搜索功能）。
- 需要链式查询（如分页、排序、多条件组合）。
- 示例：
# 搜索功能（结果可能为空） books = Book.objects.filter(title__icontains='python') # 分页查询 books = Book.objects.filter(category='tech').order_by('-pub_date')[:10]
5. 常见错误案例
错误使用get()的场景
# 错误：title 可能不唯一，导致 MultipleObjectsReturned book = Book.objects.get(title="Python") # 正确：使用 filter().first() book = Book.objects.filter(title="Python").first()
低效的filter()使用
# 低效：两次数据库查询
if Book.objects.filter(id=1).exists():
book = Book.objects.get(id=1) # 重复查询
# 高效：单次查询
book = Book.objects.filter(id=1).first()
6. 总结
| 场景 | 方法 |
|---|---|
| 通过主键/唯一键获取单个对象 | get()（需确保存在） |
| 安全获取单个对象（不存在时返回 None） | filter().first() |
| 查询可能存在多个结果或空结果 | filter() |
| 需要链式查询（如分页、排序） | filter() |
建议：优先使用 filter().first() 替代 get()，除非你能绝对保证查询条件的唯一性和存在性。
到此这篇关于Django中get()与filter()的区别及常见错误的文章就介绍到这了,更多相关Django中get()与filter()内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
Python函数默认返回None是因为在语法层面,解释器会主动地为没有return语句的函数添加一个返回逻辑,返回值为None2024-11-11
这篇文章主要介绍了使用Python从网上爬取特定属性数据保存的方法，其中解决了编码问题和如何使用正则匹配数据的方法，详情看下文2013-11-11
Python 十六进制整数与ASCii编码字符串相互转换方法
今天小编就为大家分享一篇Python 十六进制整数与ASCii编码字符串相互转换方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-07-07
详解Python中的Numpy、SciPy、MatPlotLib安装与配置
这篇文章主要介绍了详解Python中的Numpy、SciPy、MatPlotLib安装与配置，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-11-11
这篇文章主要介绍了python3 sqlite3限制条件查询的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2021-04-04
当需要遍历指定文件夹下的所有文件名时,Python提供了多种方法来实现这个任务,本文将介绍如何使用Python来完成这一任务,有需要的小伙伴可以参考下2024-01-01
项目需要爬取评论数据，在此做一个记录，这里爬取的是web端的数据，以后可能会考虑爬取android app中的数据。2021-05-05
本文分享的是Python技巧匿名函数、回调函数和高阶函数,我们在Python中使用lambda表达式来使用匿名函数，回调函数即callback，先写一个函数，让预先写好的系统来调用，一个函数可以作为参数传给另外一个函数，或者一个函数的返回值为另外一个函数，满足其一则为高阶函数2021-12-12
这篇文章主要介绍了Python局部变量与全局变量区别原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-07-07
这篇文章主要介绍了django-捕获异常和日志系统过程详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2019-07-07
最新评论