如何修改Django ORM默认SQL列名转换规则适配MySQL下划线命名？

阿华AIGC实验室

2026-5-20

解决Django ORM驼峰命名自动转MySQL下划线命名的DRY方案

完全理解你的痛点——手动给每个字段加db_column不仅繁琐，还彻底违反了DRY原则。我之前也遇到过同样的问题，摸索出了一套自动转换的方案，不用重复写任何配置，直接让ORM和数据库命名风格自动对齐。

实现思路

核心是通过自定义模型元类，自动将ORM中的驼峰式字段名转换为下划线格式的数据库列名，同时兼容外键、普通字段等不同字段类型的默认规则（比如外键自动加_id后缀）。

具体步骤

1. 编写驼峰转下划线的工具函数

这个函数负责把ownerAccount这类驼峰名转成owner_account，还能处理连续大写字母的场景（比如APIKey转成api_key）：

def camel_to_snake(name):
    import re
    # 拆分首字母后的大写单词（比如OwnerAccount → owner_account）
    s1 = re.sub('(.)([A-Z][a-z]+)', r'\1_\2', name)
    # 拆分连续的大写字母（比如APIKey → api_key）
    return re.sub('([a-z0-9])([A-Z])', r'\1_\2', s1).lower()

2. 自定义模型元类

通过重写ModelBase的add_field方法，自动给未指定db_column的字段设置转换后的列名：

from django.db.models.base import ModelBase
from django.db.models import ForeignKey, OneToOneField, ManyToManyField

class CamelCaseToSnakeCaseModelMeta(ModelBase):
    def add_field(self, cls, field, private=False):
        # 仅当字段未手动指定db_column时自动处理
        if not field.db_column:
            snake_name = camel_to_snake(field.name)
            # 外键和一对一字段默认需要加_id后缀
            if isinstance(field, (ForeignKey, OneToOneField)):
                field.db_column = f"{snake_name}_id"
            # 多对多字段的中间表列名由Django自动处理，无需干预
            elif not isinstance(field, ManyToManyField):
                field.db_column = snake_name
        # 调用父类方法完成字段添加
        super().add_field(cls, field, private)

3. 创建抽象基类并应用元类

创建一个抽象基类，让所有业务模型继承它，这样所有模型都会自动应用命名转换规则：

from django.db import models

class BaseModel(models.Model):
    class Meta:
        abstract = True
        metaclass = CamelCaseToSnakeCaseModelMeta

4. 在业务模型中使用

现在你可以直接用驼峰式命名字段，无需任何额外配置：

class OwnerAccount(models.Model):
    userName = models.CharField(max_length=100)
    emailAddress = models.EmailField()

class YourModel(BaseModel):
    # 自动对应数据库中的owner_account_id列
    ownerAccount = models.ForeignKey(OwnerAccount, on_delete=models.CASCADE)
    # 自动对应数据库中的product_name列
    productName = models.CharField(max_length=200)