如何用django-countries多值CountryField查询符合条件的Person实例？

对于你定义的CountryField(multiple=True)字段，django-countries确实提供了专属的简洁查询方式，无需当作普通CharField处理复杂的字符串匹配逻辑。

1. 查询拥有单个国籍的实例 #

要筛选出拥有美国（US）国籍的Person实例，直接使用__contains查询即可，django-countries会自动处理多选字段的逗号分隔逻辑，确保匹配完整的国家代码：

# 直接传入国家代码字符串
Person.objects.filter(citizenship__contains='US')

# 或者使用 Country 对象（更严谨）
from django_countries.fields import Country
Person.objects.filter(citizenship__contains=Country(code='US'))

2. 复杂查询：拥有美国或英国国籍 #

对于“或”逻辑的多国籍查询，结合Django的Q对象即可实现简洁写法：

from django.db.models import Q

# 筛选拥有 US 或 GB 国籍的实例
Person.objects.filter(Q(citizenship__contains='US') | Q(citizenship__contains='GB'))

对比普通CharField查询 #

如果当作普通CharField处理，为了避免部分匹配（比如误匹配包含US子串的其他代码），需要手动处理多种边界情况，写法繁琐：

Person.objects.filter(
    Q(citizenship='US') |
    Q(citizenship__startswith='US,') |
    Q(citizenship__endswith=',US') |
    Q(citizenship__contains=',US,')
)

而django-countries的专属查询已经封装了这些逻辑，让代码更简洁可读。

内容的提问来源于stack exchange，提问作者rtaft