## 📋 目录

- 一、工具类功能
- 二、所需环境
- 三、方法与调用示例（按需调用）
- 四、工具类源码（可直接复制）

## 一、工具类功能

给列表按单个字段或几个字段依次排序，支持升降序切换、空值安全与中文拼音序，另给两个可直接复用的比较器，不必再手写 Comparator 样板。

## 二、所需环境

JDK 17或以上

## 三、方法与调用示例（按需调用）

🔢 **方法序号**：1

🎯 **方法用途**：
- 把列表按一个字段原地排成升序，空值自动落到最前
- 不用自己拼 `Comparator.comparing(...)`，也不用先决定 `null` 摆哪头

🧩 **方法定义**：`public static <T, C extends Comparable<? super C>> void sortAsc(List<T> list, Function<? super T, ? extends C> keyExtractor)`

🗣️ **入参解释**：`public static <T, C extends Comparable<? super C>> void sortAsc(待排序列表, key提取函数)`

📤 **返回值解释**：`void`，顺序直接改在传进来的列表上，不返回新列表

💡 **边界口径**：
- 元素本身是 `null`、或提取出来的字段是 `null`，都算空值，一起排到最前
- 原地重排要求列表可变，`List.of(...)` 与 `Stream.toList()` 的结果都抛 `UnsupportedOperationException`
- 列表或提取函数传 `null` 抛 `IllegalArgumentException`，要保住原列表就先 `new ArrayList<>(list)` 再排

🧪 **方法示例**：
- `sortAsc(list, Emp::salary)` 原地重排后薪资变成 `[-, null, 5000, 7000, 9000]`，`list` 里混了一个 `null` 元素和一个薪资为 `null` 的员工
- `sortAsc(new ArrayList<>(), Emp::salary)` 拿到 `[]`，空列表照常走完
- `sortAsc(one, Emp::salary)` 拿到 `[null]`，只有一个 `null` 元素也不报错
- `sortAsc(List.of(new Emp(1, "tech", 9000)), Emp::salary)` 抛 `UnsupportedOperationException`，且 `getMessage()` 是 `null`
- `sortAsc(emps(), null)` 抛 `IllegalArgumentException: key提取函数不能为null`

---

🔢 **方法序号**：2

🎯 **方法用途**：
- 把列表按一个字段原地排成降序，空值一律落到最后
- 字段值本身就是倒序，不用再写 `reversed()` 或把结果整体反转一遍

🧩 **方法定义**：`public static <T, C extends Comparable<? super C>> void sortDesc(List<T> list, Function<? super T, ? extends C> keyExtractor)`

🗣️ **入参解释**：`public static <T, C extends Comparable<? super C>> void sortDesc(待排序列表, key提取函数)`

📤 **返回值解释**：`void`，顺序直接改在传进来的列表上，不返回新列表

💡 **边界口径**：
- 与升序互为镜像：把升序结果整体反转，得到的就是这个方法的顺序
- 空值落位与升序相反，元素为 `null` 和字段为 `null` 都排到最后
- 参数校验同升序：`null` 列表或 `null` 提取器抛 `IllegalArgumentException`，不可变列表抛 `UnsupportedOperationException`

🧪 **方法示例**：
- `sortDesc(list, Emp::salary)` 原地重排后薪资变成 `[9000, 7000, 5000, null, -]`
- `sortDesc(emps(), null)` 抛 `IllegalArgumentException: key提取函数不能为null`

---

🔢 **方法序号**：3

🎯 **方法用途**：
- 把列表按你给的几个字段依次排成升序，前一个字段比出结果就不再往下看
- 多字段比较器链不用自己一个个 `thenComparing` 串，空值落位也一并定好

🧩 **方法定义**：`public static <T> void sortMultiAsc(List<T> list, Function<? super T, ? extends Comparable<?>>... keyExtractors)`

🗣️ **入参解释**：`public static <T> void sortMultiAsc(待排序列表, 依次比较的key提取函数)`

📤 **返回值解释**：`void`，顺序直接改在传进来的列表上，不返回新列表

💡 **边界口径**：
- 空值按该字段的最小值参与比较：元素为 `null` 时该元素整体排最前，只有字段为 `null` 时只在这个字段上算最小，后面的字段不再影响它
- 一个提取函数都没传、提取函数数组为 `null`、数组里某项为 `null`，都抛 `IllegalArgumentException`，消息会点名是第几个
- 同一个字段上出现互不可比的两种类型（一会儿 `Integer` 一会儿 `String`），比较时由 `compareTo` 抛 `ClassCastException`

🧪 **方法示例**：
- `sortMultiAsc(list, Emp::dept, Emp::salary)` 部门与薪资变成 `[-, hr/null, sale/5000, tech/7000, tech/9000]`，同部门的 7000 排在 9000 之前
- `sortMultiAsc(list, Emp::dept, Emp::salary)` 拿到 `[-, null/100, tech/5000, tech/7000]`，`null` 元素最前、部门为 `null` 的排在有部门的前面
- `sortMultiAsc(list, Emp::salary)` 拿到 `[-, null, 5000, 7000, 9000]`，只给一个字段时等价于升序入口
- `sortMultiAsc(emps())` 抛 `IllegalArgumentException: 至少需要一个key提取函数`
- `sortMultiAsc(emps(), null, Emp::salary)` 抛 `IllegalArgumentException: key提取函数第1个为null`
- `sortMultiAsc(mixed, emp -> emp.id() % 2 == 0 ? emp.dept() : emp.salary())` 抛 `ClassCastException: class java.lang.Integer cannot be cast to class java.lang.String`

---

🔢 **方法序号**：4

🎯 **方法用途**：
- 把列表按几个字段依次排成降序，每个字段都各自倒着比
- 空值收在最后，省去「降序时 `null` 跑到最前」再补一次过滤或翻转

🧩 **方法定义**：`public static <T> void sortMultiDesc(List<T> list, Function<? super T, ? extends Comparable<?>>... keyExtractors)`

🗣️ **入参解释**：`public static <T> void sortMultiDesc(待排序列表, 依次比较的key提取函数)`

📤 **返回值解释**：`void`，顺序直接改在传进来的列表上，不返回新列表

💡 **边界口径**：
- 每个字段都是降序：部门 `tech` 排在 `hr` 前，同部门内薪资高的排前面
- 空值仍按该字段最小值处理，所以在降序里落到最后，`null` 元素排在整个列表末尾
- 参数校验与异常口径同方法3

🧪 **方法示例**：
- `sortMultiDesc(list, Emp::dept, Emp::salary)` 部门与薪资变成 `[tech/9000, tech/7000, sale/5000, hr/null, -]`
- `sortMultiDesc(list, Emp::dept, Emp::salary)` 拿到 `[tech/7000, tech/5000, null/100, -]`，`null` 部门与 `null` 元素都被挤到最后
- `sortMultiDesc(list, Emp::salary)` 拿到 `[9000, 7000, 5000, null, -]`，与降序入口结果一致

---

🔢 **方法序号**：5

🎯 **方法用途**：
- 把中文列表按拼音字母序原地排成升序，`null` 放最前还是最后由第二个参数决定
- 不用自己引拼音库，JDK 的中文排序权重已经包好

🧩 **方法定义**：`public static void sortChinesePinyinAsc(List<String> list, boolean nullsFirst)`

🗣️ **入参解释**：`public static void sortChinesePinyinAsc(待排序列表, null是否排最前)`

📤 **返回值解释**：`void`，顺序直接改在传进来的列表上，不返回新列表

💡 **边界口径**：
- 拼音序来自 `Collator.getInstance(Locale.CHINA)`，不保证多音字取到期望读音，实测「重庆」按 zhòng 排在「北京」「上海」之后，姓名类强要求场景要自备拼音字典
- `nullsFirst` 只决定 `null` 的位置，与升序方向无关，给 `false` 时 `null` 排到最后
- 英文与空串按同一套权重混排，实测排在中文之前；列表传 `null` 抛 `IllegalArgumentException`

🧪 **方法示例**：
- `sortChinesePinyinAsc(cityList, true)` 城市变成 `[null, 安康, 北京, 上海, 台湾, 香港]`，`null` 在最前
- `sortChinesePinyinAsc(cityList, false)` 拿到 `[安康, 北京, 上海, null]`，同一个开关把 `null` 挪到最后
- `sortChinesePinyinAsc(Arrays.asList("北京", "重庆", "上海"), true)` 拿到 `[北京, 上海, 重庆]`，「重」按常用音 zhòng 排
- `sortChinesePinyinAsc(mixed, true)` 拿到 `[, abc, 安康, 北京]`，空串与英文排在中文前面

---

🔢 **方法序号**：6

🎯 **方法用途**：
- 把中文列表按拼音字母序原地倒排成降序，`null` 位置仍由参数决定
- 方向反转在比较器里做完了，不用 `Collections.reverse` 再动一次列表

🧩 **方法定义**：`public static void sortChinesePinyinDesc(List<String> list, boolean nullsFirst)`

🗣️ **入参解释**：`public static void sortChinesePinyinDesc(待排序列表, null是否排最前)`

📤 **返回值解释**：`void`，顺序直接改在传进来的列表上，不返回新列表

💡 **边界口径**：
- 降序是拼音比较器整体取反，多音字与中英混排的口径与方法5 完全一致
- `nullsFirst=true` 时 `null` 仍在最前，方向不影响它的位置
- 列表传 `null` 抛 `IllegalArgumentException`，不可变列表抛 `UnsupportedOperationException`

🧪 **方法示例**：
- `sortChinesePinyinDesc(cityList, false)` 城市变成 `[香港, 台湾, 上海, 北京, 安康, null]`，`null` 收尾
- `sortChinesePinyinDesc(cityList, true)` 拿到 `[null, 上海, 北京, 安康]`，`null` 换到最前、其余仍是拼音倒序

---

🔢 **方法序号**：7

🎯 **方法用途**：
- 造一个「空值排最前、字段按自然升序」的 `Comparator`，交给 `list.sort` 或 stream 用
- 排序入口不止工具类这几个方法，`TreeMap`、`PriorityQueue`、`stream().sorted()` 都能直接拿它当比较器

🧩 **方法定义**：`public static <T, C extends Comparable<? super C>> Comparator<T> nullsFirstNatural(Function<? super T, ? extends C> keyExtractor)`

🗣️ **入参解释**：`public static <T, C extends Comparable<? super C>> Comparator<T> nullsFirstNatural(key提取函数)`

📤 **返回值解释**：`Comparator<T>`，一个可复用的比较器，本身不碰任何列表

💡 **边界口径**：
- 与 `sortAsc` 用的是同一个比较器，两者排出来的顺序完全一致
- 只造比较器、不排序，可以存成局部变量反复用
- 提取器传 `null` 抛 `IllegalArgumentException: key提取函数不能为null`

🧪 **方法示例**：
- `list.sort(SortUtils.nullsFirstNatural(Emp::salary))` 薪资变成 `[-, null, 5000, 7000, 9000]`
- `emps().stream().sorted(SortUtils.nullsFirstNatural(Emp::salary)).toList()` 拿到 `[-, null, 5000, 7000, 9000]`，比较器能直接喂给 stream
- `nullsFirstNatural(null)` 抛 `IllegalArgumentException: key提取函数不能为null`

---

🔢 **方法序号**：8

🎯 **方法用途**：
- 造一个「空值排最后、字段仍按自然升序」的 `Comparator`
- 只想把 `null` 挪到末尾时用它是「空值最后 + 值升序」，要「值本身倒序」得用 `sortDesc`

🧩 **方法定义**：`public static <T, C extends Comparable<? super C>> Comparator<T> nullsLastNatural(Function<? super T, ? extends C> keyExtractor)`

🗣️ **入参解释**：`public static <T, C extends Comparable<? super C>> Comparator<T> nullsLastNatural(key提取函数)`

📤 **返回值解释**：`Comparator<T>`，一个可复用的比较器，本身不碰任何列表

💡 **边界口径**：
- 字段值仍是升序，只有空值（元素为 `null` 或字段为 `null`）被挪到最后
- 与方法7 只差空值落位，二者可自由组合进 `thenComparing`
- 提取器传 `null` 抛 `IllegalArgumentException: key提取函数不能为null`

🧪 **方法示例**：
- `emps().stream().sorted(SortUtils.nullsLastNatural(Emp::salary)).toList()` 薪资变成 `[9000, 7000, 5000, null, -]`
- `emps().stream().sorted(SortUtils.nullsLastNatural(Emp::dept)).toList()` 拿到 `[Emp[id=4, dept=hr, salary=null], Emp[id=2, dept=sale, salary=5000], Emp[id=1, dept=tech, salary=9000], Emp[id=3, dept=tech, salary=7000], null]`，部门按 hr、sale、tech 升序，`null` 元素在最后
- `nullsLastNatural(null)` 抛 `IllegalArgumentException: key提取函数不能为null`

## 四、工具类源码（可直接复制）

📦 见评论区



给列表按单个字段或几个字段依次排序，支持升降序切换、空值安全与中文拼音序，另给两个可直接复用的比较器，不必再手写 Comparator 样板。

Java集合排序工具类8个方法，支持多字段与空值安全

编程语言

开发工具

Java排序工具类：支持单字段/多字段升降序排序、空值安全处理、中文拼音排序，提供nullsFirst/nullsLast比较器。基于JDK17，无需手写Comparator样板代码，兼容List.sort与Stream API，简化开发流程。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Java集合排序工具类8个方法，支持多字段与空值安全-腾讯云开发者社区-腾讯云

Java集合排序工具类8个方法，支持多字段与空值安全

Java集合排序工具类8个方法，支持多字段与空值安全

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐