Python Django项目中如何修改models字段的max_length参数

按以下流程操作即可完成修改，示例基于Django 3.2+版本，低版本Django操作逻辑完全一致。

• 第一步：修改模型层字段定义
  找到对应app下models.py里的目标模型字段，直接把max_length=100的参数值替换为5000即可。
  调整前代码示例：

from django.db import models

class Article(models.Model):
    # 需要修改的目标字段，当前max_length配置为100
    abstract = models.CharField(max_length=100, verbose_name="文章摘要")
    publish_time = models.DateTimeField(auto_now_add=True)

调整后代码示例：

from django.db import models

class Article(models.Model):
    # max_length已调整为目标值5000
    abstract = models.CharField(max_length=5000, verbose_name="文章摘要")
    publish_time = models.DateTimeField(auto_now_add=True)

注意：如果你使用MySQL作为数据库，其原生Char类型最大支持长度为255，Django会自动将max_length超过255的CharField适配为longtext类型，不需要手动修改字段类型；如果你的字段本身存储的是长文本内容，更推荐直接使用models.TextField()，不需要设置max_length，不存在数据库兼容问题。

• 第二步：生成数据库迁移文件
  进入项目包含manage.py的根目录，执行以下命令生成迁移脚本：
  python manage.py makemigrations
  执行成功后终端会输出类似提示，代表迁移文件生成成功：

Migrations for 'blog':
  blog/migrations/0002_alter_article_abstract.py
    - Alter field abstract on article

如果执行过程中终端提示你为字段设置默认值，是因为该字段之前未配置null=True或默认值，且数据库中已有存量数据，按提示输入需要的默认值即可（比如空字符串输入''后回车）。

• 第三步：执行迁移同步改动到数据库
  继续在根目录执行以下命令，将字段改动同步到实际数据库表中：
  python manage.py migrate
  执行成功后终端会输出所有已执行的迁移记录，看到刚生成的0002迁移文件标记为OK，就代表操作完成。
• 可选：验证配置是否生效
  可以启动Django shell验证模型层配置是否正确，执行python manage.py shell后输入以下代码：

from blog.models import Article
# 输出值为5000即代表配置生效
print(Article._meta.get_field('abstract').max_length)

• 异常处理（SQLite数据库专属）
  如果你使用SQLite作为数据库，执行迁移时出现字段类型不匹配的报错，可以打开刚生成的迁移文件，将原有的AlterField操作替换为以下写法，跳过数据库层面的强制修改（SQLite本身对字符串长度没有强制校验，不影响实际使用）：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('blog', '0001_initial'),
    ]

    operations = [
        migrations.SeparateDatabaseAndState(
            state_operations=[
                migrations.AlterField(
                    model_name='article',
                    name='abstract',
                    field=models.CharField(max_length=5000, verbose_name="文章摘要"),
                ),
            ],
            # 数据库层面不执行实际修改，SQLite无字符串长度限制不影响使用
            database_operations=[],
        )
    ]

修改完迁移文件后重新执行python manage.py migrate即可。

内容的提问来源于stack exchange，提问作者Rita