Django数据库迁移深度指南：migrate与makemigrations如何管理Schema变更（新手必读）-北京尧图网络

Django数据库迁移深度指南migrate与makemigrations如何管理Schema变更新手必读【免费下载链接】djangoThe Web framework for perfectionists with deadlines.项目地址: https://gitcode.com/GitHub_Trending/dj/djangoDjango 数据库迁移Migrations是管理数据库 Schema 变更的核心机制只需makemigrations和migrate两条命令就能把模型代码的每一次改动安全地同步到数据库。本指南面向新手讲清这两条命令的职责、常用辅助命令与常见坑让你彻底告别手动改表结构。1️⃣ 为什么需要 Django 数据库迁移想象你改了一个字段把Title从短文本变长、新增一个必填字段、或者干脆删掉一张表。数据库不会自动感知这些变化——模型代码.py和数据库表结构Schema必须保持一致否则轻则报字段不存在重则数据错乱。Django 迁移的思路非常直观概念类比说明迁移文件数据库的代码提交记录每个.py文件描述一次 Schema 变更按顺序编号makemigrationsgit diff对比模型与当前 Schema生成变更脚本migrategit apply按顺序把迁移执行到数据库所有迁移文件都集中存放在各应用的migrations/目录例如 django/db/migrations/ 就是 Django 框架自身应用的迁移目录团队里每个成员执行相同的迁移序列得到的数据库结构完全一致。2️⃣ 第一步makemigrations 生成迁移文件当你修改了模型比如给Question加一个slug字段运行python manage.py makemigrations它的工作流程是自动检测器django/db/migrations/autodetector.py对比你写好的模型定义和上一次迁移记录的 Schema 状态差异被翻译成AddField、AlterField、CreateModel等操作对象自动生成一个类似0002_question_slug.py的迁移文件。小技巧加--check参数只检测不写文件适合放进 CI 检查是否有人改了模型忘了提交迁移。源码实现见 makemigrations.py。上基于模型自动生成的后台表单——模型字段一变表单随之改变这正是Schema 与代码一致的价值所在。3️⃣ 第二步migrate 把变更应用到数据库python manage.py migrate这条命令Updates database schema. Manages both apps with migrations and those without.见 migrate.py。它会查询数据库中的迁移记录表找出哪些迁移已执行按依赖顺序执行器负责依次运行未执行的迁移每一步都在数据库事务中完成失败可整体回滚避免留下半成品表结构。常用参数速查参数作用migrate polls只迁移polls应用migrate zero回滚该应用的所有迁移撤销到空状态migrate --plan只列出将要执行的迁移不真正执行migrate --fake标记为已执行但不跑 SQL适用于手工已建表场景4️⃣ 三个新手救星命令showmigrations查看迁移状态python manage.py showmigrations每个迁移前会打[X]已执行或[ ]待执行是排查我到底跑到哪一步了的第一工具。源码showmigrations.py。sqlmigrate只看 SQL 不执行python manage.py sqlmigrate polls 0002把指定迁移翻译成纯 SQL 打印出来——上线前预演表结构变更、评估锁表风险时非常有用。源码sqlmigrate.py。squashmigrations合并历史迁移文件积累多了比如上百个会拖慢初始化速度squashmigrations能把一段历史压缩成一个文件。源码squashmigrations.py。5️⃣ 团队协作中的典型场景上Schema 同步后后台数据列表正常展示——这正是迁移机制保障的代码与数据库一致效果。同事 A 改了模型他提交迁移文件同事 Bgit pull后执行migrate本地数据库即刻对齐多人同时开发冲突如果两个迁移都叫0003_xxx产生编号冲突用makemigrations --merge生成合并迁移即可部署新环境全新数据库直接跑migrate会按 0001 → 0002 → … 顺序把全部历史迁移执行完一步到位。加载迁移的底层逻辑在 loader.py它会把各应用的迁移构建成一个有向无环图DAG保证依赖关系正确。6️⃣ 新手避坑清单❌ 坑✅ 正确做法手工改数据库表后不记录改动模型后用makemigrations补一个迁移删字段/改类型时直接执行先用sqlmigrate预览大数据表评估停机时间在迁移里写业务逻辑数据迁移放在RunPython中且必须可逆、幂等忘记提交迁移文件团队约定改模型必须同时提交迁移7️⃣ 总结记住两条命令即可入门完整流程一句话改模型 →makemigrations生成脚本 → 审查脚本 →migrate应用到数据库。想深入实践推荐阅读官方教程文档 howto/writing-migrations.txt里面手把手演示了手写迁移、处理冲突和数据迁移命令参数的完整定义可对照 migrate.py 与 makemigrations.py。掌握这套机制后你的 Django 数据库 Schema 变更就像代码一样——可追踪、可回滚、可协作。【免费下载链接】djangoThe Web framework for perfectionists with deadlines.项目地址: https://gitcode.com/GitHub_Trending/dj/django创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Django数据库迁移深度指南：migrate与makemigrations如何管理Schema变更（新手必读）

相关推荐

手机相机实拍对比测试全流程：从变量控制到EXIF样张分析

689款开源应用：打造你的专属macOS生产力工具箱

零靠墙电动沙发深度解析：顾家6601B如何实现扫地机自由

更多资讯

ASP影视站源码解析：从部署到二次开发全指南

QuartusⅡ交通灯控制电路设计：状态机与Verilog实现

STM32F103实现1024点FFT频谱分析：从ADC采样到串口输出的完整工程示例

STC8G1K08驱动WS2812：8脚单片机带240颗RGB灯实战

Office宏被阻止？MOTW标记与信任位置全解析

如何编写你自己的Claude-Skill：从SKILL.md到Python工具的完整教程

今日更新

Verilog实现FPGA密码锁：矩阵键盘与状态机设计实战

数据服务监控运维实战：从指标体系到告警治理与故障排查

FreeRTOS任务通知实战详解：内核原理、API与避坑指南

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？