Mimesis：虚假数据生成器

---

文档: https://mimesis.name/

---

Mimesis（/mɪˈmiːsɪs）是一款功能强大的 Python 数据生成工具，能够以多种语言生成各类虚假数据。

其主要特性包括：

• 多语言支持：支持 46 种不同的本地化环境。
• 可扩展性：支持自定义数据提供者和自定义字段处理器。
• 易用性：设计简洁、文档清晰，便于快速生成数据。
• 高性能：被广泛认为是 Python 生态中最高效的的数据生成工具。
• 数据多样性：内置多种适用于不同场景的数据提供者。
• 基于模式的生成器：提供基于模式的数据生成器，轻松生成任意复杂度的数据。
• 关系型数据：支持生成包含模式间引用的关系型数据，适用于复杂的数据结构。
• 直观友好：对编辑器支持良好。完全类型化，因此几乎在所有地方都支持自动补全。

安装

[!警告] 在 Mimesis 20.0.0 版本中，我将彻底重构当前基于模式的生成实现。新版本将不向后兼容现有实现。

[!重要提示] 若要在 Python 3.8 和 3.9 上使用 Mimesis，最后兼容的版本是 Mimesis 11.1.0。请安装此特定版本以确保兼容性。

[!警告] 自 19.0.0 版本起，Mimesis 已不再支持内置数据提供者。

要安装 mimesis，请使用 pip：

~ pip install mimesis

文档

完整的文档可在 Read the Docs 上找到。

文档分为以下几个部分：

• 关于 Mimesis
• 快速入门
• 本地化环境
• 数据提供者
• 结构化数据生成
• 随机数与种子
• 与 factory_boy 的集成
• API 参考
• 变更日志

您可以通过向本仓库提交 Pull Request 来改进文档。

使用方法

该库非常易于使用，只需导入与所需数据类型相对应的 数据提供者 对象即可。

例如，可以导入 Person 提供者来获取个人信息，包括姓名、姓氏、电子邮件等字段：

from mimesis import Person
from mimesis.locales import Locale

person = Person(Locale.EN)

person.full_name()
# 输出: 'Brande Sears'

person.email(domains=['example.com'])
# 输出: 'roccelline1878@example.com'

person.email(domains=['mimesis.name'], unique=True)
# 输出: 'f272a05d39ec46fdac5be4ac7be45f3f@mimesis.name'

person.telephone(mask='1-4##-8##-5##3')
# 输出: '1-436-896-5213'

许可证

Mimesis 采用 MIT 许可证授权。更多信息请参阅 LICENSE 文件。

Mimesis 快速上手指南

Mimesis 是一个强大的 Python 假数据生成库，支持 46 种语言环境，以高性能和丰富的数据类型著称，适用于测试数据构造、原型开发等场景。

环境准备

• 操作系统：跨平台支持（Linux, macOS, Windows）
• Python 版本：
  • 推荐版本：Python 3.10 - 3.14 或 PyPy
  • 兼容版本：若需使用 Python 3.8 或 3.9，请安装 mimesis==11.1.0
• 依赖管理：确保已安装 pip

安装步骤

使用 pip 直接安装最新版：

pip install mimesis

注意：从 v19.0.0 起，内置提供者（builtin providers）已被移除；从 v20.0.0 起，基于 Schema 的生成机制将重构且不向后兼容。

基本使用

Mimesis 的使用非常直观，只需导入对应的数据提供者（Provider）即可生成特定类型的假数据。以下以生成个人信息为例：

from mimesis import Person
from mimesis.locales import Locale

# 初始化提供者，指定语言环境（此处为英文）
person = Person(Locale.EN)

# 生成全名
print(person.full_name())
# 输出示例: 'Brande Sears'

# 生成指定域名的邮箱
print(person.email(domains=['example.com']))
# 输出示例: 'roccelline1878@example.com'

# 生成唯一邮箱
print(person.email(domains=['mimesis.name'], unique=True))
# 输出示例: 'f272a05d39ec46fdac5be4ac7be45f3f@mimesis.name'

# 生成符合掩码格式的电话号码
print(person.telephone(mask='1-4##-8##-5##3'))
# 输出示例: '1-436-896-5213'

通过切换 Locale 参数（如 Locale.ZH），可轻松生成中文或其他语言的假数据。更多数据类型（如地址、金融、网络等）请参考官方文档中的数据提供者章节。