faker 是一个用于生成伪造数据的 Python 库，非常适合用于测试、填充数据库、生成样例数据等场景。下面介绍它的基本用法和常见功能。

1. 安装 Faker

使用 pip 安装：

pip install faker

2. 基本使用流程

1. 创建 Faker 实例：

   from faker import Faker
   fake = Faker() # 默认生成英文数据

2. 生成伪造数据：

   print(fake.name()) # 随机姓名
   print(fake.address()) # 随机地址
   print(fake.email()) # 随机邮箱
   print(fake.phone_number()) # 随机电话号码

3. 常用数据类型

3.1 个人信息

fake.name()          # 姓名：'Dr. Elizabeth Johnson'
fake.first_name()    # 名字：'Jason'
fake.last_name()     # 姓氏：'Williams'
fake.email()         # 邮箱：'jason.williams@example.com'
fake.phone_number()  # 电话：'(986) 337-3401'
fake.ssn()           # 社保号：'642-91-6290'

3.2 地址信息

fake.address()       # 完整地址（含换行）
fake.street_address()  # 街道地址：'9119 Michelle Tunnel'
fake.city()          # 城市：'North Matthew'
fake.state()         # 州：'New York'
fake.country()       # 国家：'China'
fake.postcode()      # 邮编：'100001'

3.3 文本数据

fake.text()          # 段落文本
fake.sentence()      # 单句：'Provident cupiditate voluptatem.'
fake.word()          # 单词：'explicabo'
fake.paragraphs(3)   # 3 个段落的列表

3.4 网络与金融

fake.url()           # URL：'https://www.evans.com/'
fake.ipv4()          # IP 地址：'192.168.1.1'
fake.credit_card_number()  # 信用卡号：'4532 3090 8290 3028'

3.5 日期与时间

fake.date_of_birth(minimum_age=18, maximum_age=90)  # 生日：'1985-03-12'
fake.date_this_decade()  # 近十年内的日期
fake.time()              # 时间：'14:30:25'

4. 本地化支持

生成特定语言/地区的数据：

fake = Faker('zh_CN')  # 中文数据
print(fake.name())     # 姓名：'张伟'
print(fake.address())  # 地址：'江苏省苏州市虎丘区长安路e座 215000'

fake = Faker('en_US')  # 美国英语数据
fake = Faker('ja_JP')  # 日本语数据

5. 生成唯一数据

使用 unique 确保生成的数据不重复：

unique_names = [fake.unique.name() for _ in range(5)]
print(unique_names)  # 5 个不同的姓名

6. 生成批量数据

结合循环生成多条数据，例如创建用户列表：

users = []
for _ in range(3):
    user = {
        'name': fake.name(),
        'email': fake.email(),
        'address': fake.address().replace('\n', ', '),
        'phone': fake.phone_number()
    }
    users.append(user)

# 打印结果
for user in users:
    print(f"{user['name']} | {user['email']} | {user['address']}")

7. 自定义 Provider

扩展 Faker 以生成特定领域的数据：

from faker import Faker
from faker.providers import BaseProvider

fake = Faker()

# 创建自定义 Provider
class MyProvider(BaseProvider):
    def game_console(self):
        consoles = ['PlayStation 5', 'Xbox Series X', 'Nintendo Switch']
        return self.random_element(consoles)

# 添加到 Faker 实例
fake.add_provider(MyProvider)

# 使用自定义 Provider
print(fake.game_console())  # 输出：'Xbox Series X'

8. 高级用法

• 种子固定：使用 seed() 确保生成的随机数据可重现。

  fake.seed(42)
  print(fake.name())  # 每次运行结果相同
  

• 随机元素选择：

  fake.random_element(['apple', 'banana', 'cherry'])  # 随机选择一个
  

总结

faker 库功能强大且易于使用，适合各种测试和数据生成场景。通过本地化和自定义 Provider，还能满足特定需求。官方文档提供了更详细的用法：Faker Documentation。