django-countries，一个超厉害的 Python 库！

更多Python学习内容：ipengtao.com

大家好，今天为大家分享一个超厉害的 Python 库 - django-countries。

Github地址：https://github.com/SmileyChris/django-countries

---

在开发涉及地理信息或国际化应用的Django项目时，经常需要处理国家和区域数据。django-countries库是一个方便的解决方案，提供了国家和区域的标准化数据，并集成到Django项目中。它不仅支持将国家数据作为模型字段，还提供了多种实用功能和自定义选项。本文将详细介绍django-countries库，包括其安装方法、主要特性、基本和高级功能，以及实际应用场景，帮助全面了解并掌握该库的使用。

安装

要使用django-countries库，首先需要安装它。可以通过pip工具方便地进行安装。

以下是安装步骤：

pip install django-countries

安装完成后，还需要将django-countries添加到Django项目的INSTALLED_APPS中：

# settings.py
INSTALLED_APPS = [
    ...
    'django_countries',
]

安装和配置完成后，可以通过运行Django的数据库迁移命令来应用更改：

python manage.py migrate

特性

1. 标准化的国家数据：提供ISO 3166-1标准的国家数据，包含国家代码和名称。

2. Django模型集成：提供CountryField字段，方便在Django模型中使用国家数据。

3. 支持国际化：内置多种语言的国家名称翻译，适用于国际化应用。

4. 灵活的自定义选项：支持自定义国家列表、排序和显示方式。

5. 丰富的工具函数：提供多种工具函数，方便进行国家数据的处理和转换。

基本功能

使用CountryField

CountryField是django-countries库提供的核心字段，用于在Django模型中存储国家数据。

以下是一个示例：

from django.db import models
from django_countries.fields import CountryField

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    country = CountryField()

    def __str__(self):
        return f'{self.user.username} - {self.country.name}'

表单中的国家选择

在Django表单中使用CountryField时，会自动生成一个带有国家选项的下拉菜单。

以下是一个示例：

from django import forms
from .models import UserProfile

class UserProfileForm(forms.ModelForm):
    class Meta:
        model = UserProfile
        fields = ['country']

显示国家名称和代码

可以通过CountryField的实例获取国家的名称和代码。

以下是一个示例：

user_profile = UserProfile.objects.get(pk=1)
print(user_profile.country)        # 显示国家代码，例如'US'
print(user_profile.country.name)   # 显示国家名称，例如'United States'
print(user_profile.country.flag)   # 显示国家旗帜的Unicode符号

高级功能

自定义国家列表

可以自定义国家列表，仅显示特定的国家。

以下是一个示例：

from django_countries import countries

# 自定义国家列表，只显示特定国家
custom_countries = countries.countries = {
    'US': 'United States',
    'CA': 'Canada',
    'GB': 'United Kingdom',
}

class CustomCountryField(CountryField):
    countries = custom_countries

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    country = CustomCountryField()

自定义国家排序

可以自定义国家排序方式。

以下是一个示例：

from django_countries import countries

# 自定义国家排序方式，按字母顺序排序
sorted_countries = sorted(countries.items(), key=lambda item: item[1])

class SortedCountryField(CountryField):
    countries = dict(sorted_countries)

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    country = SortedCountryField()

国家名称翻译

django-countries库内置了多种语言的国家名称翻译，适用于国际化应用。

以下是一个示例：

from django.utils.translation import activate
from django_countries import countries

# 激活不同的语言环境
activate('es')
print(dict(countries)['US'])  # 显示'Estados Unidos'（西班牙语）

activate('fr')
print(dict(countries)['US'])  # 显示'États-Unis'（法语）

国家数据的工具函数

django-countries库提供了多种工具函数，方便进行国家数据的处理和转换。

以下是一个示例：

from django_countries import countries
from django_countries.utils import get_country

# 获取国家对象
country = get_country('US')
print(country.name)  # 显示'United States'
print(country.alpha2)  # 显示'US'
print(country.alpha3)  # 显示'USA'
print(country.numeric)  # 显示'840'

实际应用场景

用户注册和配置文件

在用户注册和配置文件中，通常需要用户选择所在国家，可以使用django-countries库实现这一功能。

from django import forms
from django.contrib.auth.models import User
from .models import UserProfile

class UserRegistrationForm(forms.ModelForm):
    country = CountryField()

    class Meta:
        model = User
        fields = ['username', 'password', 'email', 'country']

class UserProfileForm(forms.ModelForm):
    class Meta:
        model = UserProfile
        fields = ['country']

地理数据分析

在进行地理数据分析时，需要处理大量的国家和区域数据，可以使用django-countries库简化数据处理过程。

from django_countries import countries

# 统计用户分布
user_profiles = UserProfile.objects.all()
country_count = {}

for profile in user_profiles:
    country_name = profile.country.name
    if country_name in country_count:
        country_count[country_name] += 1
    else:
        country_count[country_name] = 1

print(country_count)

国际化电商平台

在开发国际化电商平台时，需要根据用户的所在国家显示不同的产品和价格，可以使用django-countries库实现这一功能。

from django.shortcuts import render
from .models import Product, UserProfile

def product_list(request):
    user_country = request.user.profile.country
    products = Product.objects.filter(available_in_countries__contains=user_country)

    return render(request, 'product_list.html', {'products': products})

总结

django-countries库是一个功能强大且易于使用的工具，能够帮助开发者高效地处理国家和区域数据。通过支持标准化的国家数据、Django模型集成、国际化、多种自定义选项和丰富的工具函数，django-countries库能够满足各种涉及地理信息的需求。本文详细介绍了django-countries库的安装方法、主要特性、基本和高级功能，以及实际应用场景。希望本文能帮助大家全面掌握django-countries库的使用，并在实际项目中发挥其优势。

如果你觉得文章还不错，请大家 点赞、分享、留言 下，因为这将是我持续输出更多优质文章的最强动力！

---

如果想要系统学习Python、Python问题咨询，或者考虑做一些工作以外的副业，都可以扫描二维码添加微信，围观朋友圈一起交流学习。

我们还为大家准备了Python资料和副业项目合集，感兴趣的小伙伴快来找我领取一起交流学习哦！

往期推荐

历时一个月整理的 Python 爬虫学习手册全集PDF（免费开放下载）

Python基础学习常见的100个问题.pdf（附答案）

学习 数据结构与算法，这是我见过最友好的教程！(PDF免费下载)

Python办公自动化完全指南(免费PDF)

Python Web 开发常见的100个问题.PDF

肝了一周，整理了Python 从0到1学习路线（附思维导图和PDF下载）