如何为模型提供初始数据

It's sometimes useful to prepopulate your database with hardcoded data when you're first setting up an app. You can provide initial data with migrations or fixtures.

使用迁移提供初始数据

要自动加载应用程序的初始数据，请创建一个 数据迁移。迁移会在设置测试数据库时运行，因此数据将在那里可用，但受到 一些限制 的影响。

使用固定数据提供数据

你还可以使用 fixtures 提供数据，但这些数据不会自动加载，除非你使用 TransactionTestCase.fixtures。

固定内容是一个 Django 知道如何导入数据库的集合。若你已有一些可用数据，最直接的创建固定内容的方式是使用 manage.py dumpdata 命令。或者，你可以手写固定内容；固定数据能被写作 JSON，XML 或 YAML （要求已安装 PyYAML）文档。 序列化文档 拥有更多这些支持的 序列化格式 的细节信息。

举个例子，这有一个固定内容，描述了一个 Person 模型写成 JSON 后的样子：

[
  {
    "model": "myapp.person",
    "pk": 1,
    "fields": {
      "first_name": "John",
      "last_name": "Lennon"
    }
  },
  {
    "model": "myapp.person",
    "pk": 2,
    "fields": {
      "first_name": "Paul",
      "last_name": "McCartney"
    }
  }
]

以下是一样的固定内容，YAML 格式：

- model: myapp.person
  pk: 1
  fields:
    first_name: John
    last_name: Lennon
- model: myapp.person
  pk: 2
  fields:
    first_name: Paul
    last_name: McCartney

你会将该数据存入应用中的 fixtures 字典。

你可以通过调用 manage.py loaddata <fixturename> 来加载数据，其中 <fixturename> 是你创建的 fixture 文件的名称。每次运行 loaddata 时，数据将从 fixture 中读取并重新加载到数据库中。请注意，这意味着如果你更改了 fixture 创建的行之一，然后再次运行 loaddata，你将覆盖你所做的任何更改。

告诉 Django 在哪里查找固定数据文件

默认情况下，Django 会在每个应用程序的 fixtures 目录中查找固定数据，因此 loaddata sample 命令会找到文件 my_app/fixtures/sample.json。这也适用于相对路径，因此 loaddata my_app/sample 会找到文件 my_app/fixtures/my_app/sample.json。

Django 还会在 FIXTURE_DIRS 设置提供的目录列表中查找 fixtures。

要完全阻止默认搜索发生，请使用绝对路径指定固定数据文件的位置，例如 loaddata /path/to/sample。

为你的固定数据文件设置命名空间

Django 将使用它找到的第一个与名称匹配的 fixture 文件，因此如果在不同应用程序中有具有相同名称的 fixture 文件，你将无法在你的 loaddata 命令中区分它们。避免这个问题的最简单方法是通过为 fixture 文件添加 命名空间。也就是说，将它们放在以其应用程序命名的目录中，就像上面的相对路径示例中一样。

See also

固定内容通常备 测试框架 用于创建永久的测试环境。