Django模型迁移指南：从命令用法到最佳实践

一、迁移的工作原理

Django 迁移系统本质上是一套数据库版本控制系统，它通过以下三个核心环节实现模型与数据库的同步

• 生成迁移文件：当模型发生变更时，makemigrations 命令会生成记录变更的 Python 脚本，存储在应用的 migrations/ 目录下
  

1. your_app/
2. └── migrations/
3.     ├── 0001_initial.py  # 初始迁移文件
4.     └── 0002_auto_20250606_1006.py  # 自动生成的迁移文件

复制代码

• 应用迁移文件：运行migrate 命令会按顺序执行迁移文件，并通过数据库中的 django_migrations 表记录执行状态，确保每个迁移只被执行一次
  

• 回滚迁移操作：支持将数据库状态回滚到指定的历史版本，可通过指定迁移编号或 zero 实现完全回滚
  

二、生成迁移文件：makemigrations

基本用法

修改模型后（比如添加字段、删除模型、修改字段类型等），使用以下命令生成迁移文件

1. # 为指定应用生成迁移
2. python manage.py makemigrations your_app_name
4. # 为所有应用生成迁移
5. python manage.py makemigrations

复制代码

实用选项

预览迁移内容：不实际创建文件，仅查看变更内容

1. python manage.py makemigrations --dry-run

复制代码

解决迁移冲突：多开发者协作时合并迁移历史

1. python manage.py makemigrations --merge

复制代码

迁移文件解释

迁移文件是自动生成的 Python 脚本，通常位于每个 app 的 migrations/ 文件夹下

1. your_app/
2. └── migrations/
3.     ├── 0001_initial.py
4.     └── 0002_auto_20250606_1006.py

复制代码

文件主要内容包括

• 迁移依赖关系（dependencies）
  
• 操作列表（operations）：记录字段添加、删除、类型修改等具体变更
  

1. # 迁移文件示例
2. # Generated by Django 4.2.20 on 2025-07-15 08:22
4. from django.conf import settings
5. from django.db import migrations, models
6. import django.db.models.deletion
9. class Migration(migrations.Migration):
11.     dependencies = [
12.         ('myapp_system', '0001_initial'),
13.     ]
15.     operations = [
16.         migrations.AlterField(
17.             model_name='systemnotifymessage',
18.             name='user_id',
19.             field=models.ForeignKey(db_column='user_id', db_comment='接收用户ID', db_constraint=False, help_text='接收用户ID', on_delete=django.db.models.deletion.DO_NOTHING, related_name='notify_messages', to=settings.AUTH_USER_MODEL),
20.         ),
21.     ]

复制代码

点击查看迁移文件完整代码
三、应用迁移：migrate

基础用法

使用场景

• 第一次运行 Django 项目之前
  
• 修改了 models.py 中的模型定义
  
• 添加了第三方 Django 应用
  

1. # 应用所有未执行的迁移
2. python manage.py migrate
4. # 仅应用指定应用的迁移
5. python manage.py migrate myapp
7. # 应用到指定版本的迁移
8. python manage.py migrate myapp 0001

复制代码

特殊场景处理

初始化已有数据库：当数据库表结构已存在时，使用假造 - fake-initial` 选项跳过初始迁移

1. python manage.py migrate --fake-initial

复制代码

查看迁移状态：检查哪些迁移已应用，哪些未应用

1. python manage.py showmigrations

复制代码

四、遗留数据库集成：inspectdb

当需要将 Django 与遗留数据库集成时，inspectdb工具能帮我们自动生成模型代码，省去手动编写的麻烦。
基本用法

1. # 查看生成的模型代码
2. python manage.py inspectdb
4. # 将模型代码保存到文件
5. python manage.py inspectdb > my_models.py
7. # 为特定表生成模型
8. python manage.py inspectdb auth_user

复制代码

注意事项

使用重定向生成文件时，默认编码可能为 UTF-16 LE，导致 Django 无法识别，解决方法有两种：

• 手动创建 Python 文件并复制内容
  
• 使用 VSCode 打开文件，通过 "选择编码" 功能重新保存为 UTF-8
  

五、迁移回滚

回滚前的准备工作

查看当前迁移状态

1. python manage.py showmigrations [app_name]
3. # 带 [X] 标记的表示已应用的迁移，例如：
4. myapp
5.   [X] 0001_initial
6.   [X] 0002_add_email_field
7.   [X] 0003_add_age_field

复制代码

回滚前务必备份数据库，以防意外发生

1. # MySQL 数据库备份示例
2. mysqldump -u username -p dbname > backup_before_rollback.sql

复制代码

回滚操作方法

回滚到指定迁移版本

1. # 语法：python manage.py migrate [app_name] [迁移编号]
3. # 示例：将 myapp 应用回滚到 0001 版本
4. python manage.py migrate myapp 0001

复制代码

完全回滚（清空所有迁移）

1. # 完全回滚 myapp 应用的所有迁移
2. python manage.py migrate myapp zero

复制代码

回滚操作过程

• 检查目标迁移版本与当前版本的差异
  
• 自动生成反向 SQL 语句（基于迁移文件中的 operations）
  
• 执行反向操作并更新 django_migrations 表记录
  
• 不会删除迁移文件，只是标记其为未执行状态
  

六、最佳实践

• 每次模型变更后生成并测试迁移
  
• 迁移文件应纳入版本控制
  
• 生产环境执行迁移前先在测试环境验证
  
• 复杂变更建议分步骤进行，避免一次性大规模迁移
  
• 谨慎使用回滚操作，先在测试环境验证回滚流程，再操作生产环境
  

您正在阅读的是《Django从入门到实战》专栏！关注不迷路~

来源：豆瓜网用户自行投稿发布，如果侵权，请联系站长删除