### Django 中 `first()` 方法的使用 `first()` 是 Django ORM 提供的一个便捷方法，用于获取查询集中的第一个对象。如果查询集中没有任何匹配的对象，则返回 `None`。这种方法特别适用于需要快速检索首个记录而不关心其余结果的情况。 以下是关于 `first()` 的详细介绍以及示例： #### 基础语法 `QuerySet.first()` 可以直接作用于任何 QuerySet 上。它会尝试从数据库中提取符合条件的第一个对象。如果没有找到任何匹配项，则不会抛出异常而是返回 `None`[^1]。 ```python object = ModelName.objects.filter(condition).first() ``` #### 示例代码 假设有一个名为 `Book` 的模型，定义如下： ```python from django.db import models class Book(models.Model): title = models.CharField(max_length=200) author = models.CharField(max_length=100) published_date = models.DateField() def __str__(self): return self.title ``` ##### 获取第一条书籍记录 下面是一个简单的例子，展示如何使用 `first()` 来获取满足条件的第一本书籍： ```python book = Book.objects.filter(author="J.K. Rowling").first() if book: print(f"The first book by J.K. Rowling is {book.title}.") else: print("No books found.") ``` 此代码片段将打印由作者 "J.K. Rowling" 编写的首部作品名称；如果没有这样的书存在，则输出提示信息[^3]。 ##### 结合排序功能 有时我们需要按照特定顺序选取第一个条目。可以通过 `.order_by()` 配合 `first()` 实现这一需求。例如查找出版日期最早的那本书： ```python earliest_book = Book.objects.order_by('published_date').first() print(f"The earliest book was published on {earliest_book.published_date} and titled '{earliest_book.title}'.") ``` 注意这里即使没有指定过滤器也可以正常工作，因为它只是简单地取整个集合里的头一项而已[^4]。 #### 性能考虑 相比起手动实现类似的逻辑（比如先调用 all() 或者 list() 并索引），采用 `first()` 往往更加高效，因为底层 SQL 查询会被优化成只请求单个结果而不是全部数据行[^5]。 ---