省空间又更规范：Django-MySQL EnumField与FixedCharField字段详解

省空间又更规范：Django-MySQL EnumField与FixedCharField字段详解

【免费下载链接】django-mysql:dolphin: :horse: Extensions to Django for use with MySQL/MariaDB项目地址: https://gitcode.com/gh_mirrors/dj/django-mysql

django-mysql 为 Django 扩展了 MySQL/MariaDB 专属能力，其中EnumField与FixedCharField两个模型字段，能帮你"省空间、更规范"地存储字符串数据。本文面向新手，详解这两个字段的原理、用法和避坑要点，助你在 Django 项目里做出正确的字段选型。

为什么 Django 自带的 CharField 不够用？

Django 的CharField底层对应 MySQL 的VARCHAR类型——变长存储。它有两个"老问题"：

• 重复字符串反复落盘：比如一列 100 万行数据里反复出现"red"、"green"、"blue"，每个值都完整存一遍，白白浪费磁盘和索引空间。
• 定长数据反而更费：像邮编、状态码这类长度完全固定的列，VARCHAR每行还要额外记录"实际长度"，多出一小块开销。

MySQL/MariaDB 为此提供了两种更合适的数据类型：ENUM和CHAR(n)。而 django-mysql 恰好把它们封装成了两个开箱即用的模型字段——EnumField和FixedCharField，让你无需手写 SQL 就能用上。

两个字段的源码分别位于src/django_mysql/models/fields/enum.py与src/django_mysql/models/fields/fixedchar.py，且都继承自 Django 的CharField，因此choices、验证器等 Django 熟悉的能力依然可用。

EnumField 使用指南：用枚举类型省下重复存储

原理：字符串列表只存一次

EnumField让字段使用 MySQL 的ENUM类型：数据库只保存一份候选字符串列表，每行数据仅用一个整数表示"是哪一个"。候选值越少、行数越多，省下的空间越可观，同时数据天然被约束在合法集合内，更规范。

快速上手

from django.db import models from django_mysql.models import EnumField class BookCover(models.Model): colour = EnumField(choices=["red", "green", "blue"])

choices是必填参数，推荐直接用 Django 的TextChoices枚举来定义。注意：

• ❌不能传max_length：长度由 MySQL 自动管理，传了会直接报错；
• ⚠️迁移限制：可以在迁移中新增候选值、修改展示名；但若修改或删除已有值，MySQL 严格模式下会报错，非严格模式下则会变成空字符串——所以请保持候选值稳定，且建议开启严格模式。

FixedCharField 配置要点：定长 CHAR 的正确打开方式

FixedCharField对应 MySQL 的CHAR(n)类型，每行固定占n个字符，省掉了VARCHAR记录长度的小开销。

from django_mysql.models import FixedCharField class Address(models.Model): zip_code = FixedCharField(max_length=5)

使用时的三个关键点：

1. max_length必须在 0–255 之间，否则 Django 系统检查会报django_mysql.E015错误；
2. 注意尾部空格：CHAR类型会丢弃字符串尾部的空格，并忽略它们做比较，"abc"和"abc "在数据库眼中是一样的；
3. 适用场景：最适合对接其他系统创建的数据库，或存储邮编、编码等真正定长的字段，官方并不建议把它当普通CharField的通用替代品。

EnumField 与 FixedCharField 选型对比

维度	EnumField	FixedCharField
底层类型	ENUM	CHAR(n)
核心价值	候选值列表只存一次，行内仅存整数，省空间	定长存储，无变长记录的长度开销
必填参数	choices	max_length（0–255）
避坑提醒	已有值不可随意改/删，保持严格模式	尾部空格会被丢弃，比较时忽略空格
典型场景	状态、颜色、等级等封闭集合	邮编、编码、对接外部系统的定长列

一句话选型建议：候选值有限且固定，选EnumField；长度恒定、来自外部系统，选FixedCharField；两者都不符合时，老老实实用 Django 自带CharField就好。

小结

• 🐬 django-mysql 的EnumField用 MySQLENUM类型消除重复字符串存储，是"省空间又更规范"的典型代表；
• 📏FixedCharField用定长CHAR消除变长开销，但要牢记尾部空格的行为；
• 安装 django-mysql 后，字段直接从django_mysql.models导入即可，用法与 Django 原生字段几乎一致。

掌握这两个字段，你的 MySQL 表结构会更紧凑，数据约束也更清晰。

【免费下载链接】django-mysql:dolphin: :horse: Extensions to Django for use with MySQL/MariaDB项目地址: https://gitcode.com/gh_mirrors/dj/django-mysql