如何在Django中按x.y.z格式的软件版本号排序查询结果

你遇到的问题是字符串类型的版本号（如x.y.z、x、x.y）默认按字典序排序，不符合数值逻辑。以下是几种可行的解决办法：

方案1：数据库注解排序（推荐，性能最优） #

利用数据库字符串拆分函数，将版本号拆分为主版本（x）、次版本（y）、修订版本（z）三个整数段，再按这三个字段排序，全程在数据库层面完成，性能最高。

适用于PostgreSQL #

Django对PostgreSQL原生支持SplitPart函数：

from django.db.models import IntegerField
from django.db.models.functions import SplitPart

# 拆分版本号，缺失的段默认补0
software_qs = Software.objects.annotate(
    major=SplitPart('version', '.', 1, output_field=IntegerField()),
    minor=SplitPart('version', '.', 2, default='0', output_field=IntegerField()),
    patch=SplitPart('version', '.', 3, default='0', output_field=IntegerField())
).order_by('major', 'minor', 'patch')

适用于MySQL #

自定义Func封装MySQL的SUBSTRING_INDEX函数实现拆分：

from django.db.models import IntegerField, Func

class SubstringIndex(Func):
    function = 'SUBSTRING_INDEX'
    arity = 3

software_qs = Software.objects.annotate(
    major=SubstringIndex('version', '.', 1, output_field=IntegerField()),
    minor=SubstringIndex(SubstringIndex('version', '.', 2), '.', -1, output_field=IntegerField()),
    patch=SubstringIndex(SubstringIndex('version', '.', 3), '.', -1, default='0', output_field=IntegerField())
).order_by('major', 'minor', 'patch')

方案2：模型层面维护版本字段（最稳定，便于长期使用） #

修改模型结构，新增三个整数字段存储版本的各段数值，保存时自动拆分版本号同步到字段：

from django.db import models

class Software(models.Model):
    name = models.CharField(max_length=100)
    version = models.CharField(max_length=20)
    major = models.IntegerField(default=0)
    minor = models.IntegerField(default=0)
    patch = models.IntegerField(default=0)

    def save(self, *args, **kwargs):
        # 拆分版本号为整数段，缺失部分补0
        version_parts = list(map(int, self.version.split('.')))
        self.major = version_parts[0] if len(version_parts) >= 1 else 0
        self.minor = version_parts[1] if len(version_parts) >= 2 else 0
        self.patch = version_parts[2] if len(version_parts) >= 3 else 0
        super().save(*args, **kwargs)

# 直接按三个整数字段排序
software_qs = Software.objects.order_by('major', 'minor', 'patch')

注意：已有数据需要手动批量更新major/minor/patch字段，后续新增或修改版本号会自动同步。

方案3：内存中排序（适合小数据量场景） #

如果数据量不大，可先查询所有数据，再用Python的版本解析工具排序。需先安装packaging库：

pip install packaging

排序代码：

from packaging.version import Version

# 将查询集转为列表后按版本号数值排序
software_list = sorted(Software.objects.all(), key=lambda item: Version(item.version))

此方法会把所有数据加载到内存，数据量大时性能较差，不推荐用于分页或大数据场景。

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