eslint-plugin-perfectionist 新增类型分组排序功能解析
2025-06-30 13:15:50作者:裘旻烁
eslint-plugin-perfectionist 作为一款专注于代码风格一致性的 ESLint 插件,在最新发布的 3.0.0 版本中新增了对 TypeScript 类型联合和交叉类型的分组排序功能。这一改进源自社区对原 typescript-eslint 中 sort-type-constituents 规则的讨论和需求迁移。
功能背景
在 TypeScript 开发中,类型联合和交叉类型的排序一致性是代码风格的重要组成部分。原 typescript-eslint 中的 sort-type-constituents 规则提供了 groupOrder 选项,允许开发者按照特定分组顺序排列类型成员。随着该规则即将被废弃,社区希望将这一功能迁移到更活跃维护的 eslint-plugin-perfectionist 项目中。
功能详解
新实现的分组排序功能主要作用于两类 TypeScript 类型:
- 联合类型:使用
|连接的类型 - 交叉类型:使用
&连接的类型
分组排序的核心在于将不同类型的成员归类到预定义的组别中,然后按照配置的顺序排列这些组别。例如,开发者可以配置让字面量类型优先于 nullish 类型。
典型使用场景
考虑以下 TypeScript 代码示例:
// 未启用分组排序
type Example = null | 123 | string;
// 启用分组排序(配置为字面量优先)
type Example = 123 | string | null;
通过分组排序,开发者可以确保项目中类型成员的排列遵循统一的逻辑顺序,而不仅仅是字母顺序或自然顺序。这对于提高代码可读性和维护性特别有价值,尤其是在处理复杂类型定义时。
技术实现要点
- 分组策略:系统内置了常见类型的分组策略,如字面量类型、nullish 类型等
- 自定义配置:开发者可以通过配置项调整分组顺序,满足不同项目的风格要求
- 向后兼容:新功能与原有的字母/自然排序方式并存,不影响现有配置
升级建议
对于从 typescript-eslint 迁移过来的项目,建议:
- 检查现有项目中是否使用了 groupOrder 配置
- 升级到 eslint-plugin-perfectionist 3.0.0 或更高版本
- 根据项目需求调整分组排序配置
- 逐步替换原有的 sort-type-constituents 规则
这一功能的加入使得 eslint-plugin-perfectionist 在 TypeScript 代码风格检查方面更加完善,为开发者提供了更全面的代码一致性保障方案。
登录后查看全文
热门项目推荐
相关项目推荐
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00- QQwen3-Coder-Next2026年2月4日,正式发布的Qwen3-Coder-Next,一款专为编码智能体和本地开发场景设计的开源语言模型。Python00
xw-cli实现国产算力大模型零门槛部署,一键跑通 Qwen、GLM-4.7、Minimax-2.1、DeepSeek-OCR 等模型Go06
PaddleOCR-VL-1.5PaddleOCR-VL-1.5 是 PaddleOCR-VL 的新一代进阶模型,在 OmniDocBench v1.5 上实现了 94.5% 的全新 state-of-the-art 准确率。 为了严格评估模型在真实物理畸变下的鲁棒性——包括扫描伪影、倾斜、扭曲、屏幕拍摄和光照变化——我们提出了 Real5-OmniDocBench 基准测试集。实验结果表明,该增强模型在新构建的基准测试集上达到了 SOTA 性能。此外,我们通过整合印章识别和文本检测识别(text spotting)任务扩展了模型的能力,同时保持 0.9B 的超紧凑 VLM 规模,具备高效率特性。Python00
KuiklyUI基于KMP技术的高性能、全平台开发框架,具备统一代码库、极致易用性和动态灵活性。 Provide a high-performance, full-platform development framework with unified codebase, ultimate ease of use, and dynamic flexibility. 注意:本仓库为Github仓库镜像,PR或Issue请移步至Github发起,感谢支持!Kotlin08
VLOOKVLOOK™ 是优雅好用的 Typora/Markdown 主题包和增强插件。 VLOOK™ is an elegant and practical THEME PACKAGE × ENHANCEMENT PLUGIN for Typora/Markdown.Less00
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
535
3.75 K
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
12
1
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
67
20
暂无简介
Dart
773
191
Ascend Extension for PyTorch
Python
343
406
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
886
596
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
23
0
React Native鸿蒙化仓库
JavaScript
303
355
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
336
178