当前位置：首页 > article >正文

Django 框架中values和values_list的区别

article 2025/2/26 15:13:43

在Django框架中，values() 和 values_list() 是两个非常有用的方法，它们都被用于从查询集中提取数据，但它们的输出格式有所不同。

`values()`

values() 方法允许你指定一个或多个字段，Django将返回一个字典的查询集，每个字典代表查询结果中的一行，并且只包含你指定的字段。这对于需要获取多个字段但不需要整个模型实例的情况很有用。

from .models import MyModel  
  
# 假设MyModel有name和age两个字段  
queryset = MyModel.objects.values('name', 'age')  
  
# 结果可能类似于：[{'name': 'Alice', 'age': 30}, {'name': 'Bob', 'age': 25}]  
for item in queryset:  
    print(item['name'], item['age'])

`values_list()`

与values()相似，values_list()也允许你指定一个或多个字段，但它返回的是一个元组的查询集，每个元组包含了你指定的字段的值。values_list()还可以接受一个可选的flat=True参数，如果设置为True，并且只查询了一个字段，它将返回一个只包含该字段值的列表，而不是元组的列表。

from .models import MyModel  
  
# 返回元组的查询集  
queryset = MyModel.objects.values_list('name', 'age')  
  
# 结果可能类似于：[('Alice', 30), ('Bob', 25)]  
for name, age in queryset:  
    print(name, age)  
  
# 如果只查询一个字段，并设置flat=True  
queryset_flat = MyModel.objects.values_list('name', flat=True)  
  
# 结果将是一个包含name字段值的列表  
# 结果可能类似于：['Alice', 'Bob']  
for name in queryset_flat:  
    print(name)

区别总结

输出格式：values() 返回的是字典的查询集，每个字典包含指定的字段和它们的值；而values_list() 返回的是元组的查询集，每个元组包含指定的字段值。
flat=True 参数：values_list() 有一个flat=True的可选参数，当只查询一个字段并设置此参数为True时，它将返回一个简单的值列表，而不是元组的列表。
使用场景：如果你需要获取多个字段的数据，并且希望以字典的形式访问它们，那么values() 是更好的选择。如果你只需要几个字段的值，并且不关心它们是以字典还是元组的形式返回，或者你需要一个简单的值列表，那么values_list() 可能更适合你的需求。