如何对Dart项目lib目录下所有文件的类成员进行排序？

source.sortMembers的生效范围 #

source.sortMembers是Dart格式化工具的配置项，默认只对当前打开且触发格式化操作的单个文件生效，不会自动处理整个项目的未打开文件。要实现全项目排序，需要用批量格式化的方式。

批量处理的两种方法 #

方法1：通过VSCode批量格式化 #

1. 先配置排序规则：打开VSCode设置（Ctrl+, / Cmd+,），搜索dart source sortMembers，将值设为explicit。推荐在工作区设置中配置，仅对当前项目生效。
2. 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入Format All Files in Folder，选择项目的lib目录，等待VSCode完成所有文件的格式化与成员排序。

方法2：通过命令行高效处理（适合大型项目） #

1. 直接在项目根目录执行Dart格式化命令，指定排序规则和目标目录：

   dart format --sort-members explicit lib/
   

   该命令会自动遍历lib下所有Dart文件，按照explicit规则完成类成员排序。如果需要检查文件是否被修改（比如CI场景），可添加--set-exit-if-changed参数：

   dart format --set-exit-if-changed --sort-members explicit lib/
   

2. 若想把排序规则固化到项目中，可在根目录的analysis_options.yaml里添加配置：

   formatter:
     sort_members: explicit
   

   之后直接执行dart format lib/就会自动应用该规则。

注意事项 #

• 执行批量操作前，建议先提交当前代码到版本控制系统，避免格式化后的代码变更难以回溯。
• 如果需要自定义成员排序顺序（比如调整构造函数、属性、方法的排列优先级），可以在analysis_options.yaml中进一步配置sort_members的详细规则。

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