Swift-Format 601.0.0版本发布：代码格式化工具的重大更新

项目简介

Swift-Format是Swift语言生态中一个重要的代码格式化工具，它基于SwiftSyntax构建，能够按照预设规则自动格式化Swift代码。该项目由苹果官方维护，旨在为Swift开发者提供统一的代码风格规范，提升代码可读性和维护性。

核心更新内容

1. 性能优化

本次版本在性能方面做了显著改进：

• 对PrettyPrinter进行了深度优化，显著提升了打印性能
• 为WhitespaceLinter实现了手工优化的"空白字符检测"函数
• 修复了在特定情况下可能导致无限循环的性能问题

这些优化使得处理大型Swift代码库时，格式化速度明显提升，特别是在持续集成环境中效果更为显著。

2. 新规则与规则增强

• 新增"NoEmptyLinesOpeningClosingBraces"规则：禁止在开闭大括号前后出现空行
• 增强"DontRepeatTypeInStaticProperties"规则：避免在静态属性中重复类型信息
• 新增对@Test属性标记的测试函数的检查
• 添加了针对回溯协议一致性(retroactive conformances)的lint警告

3. 格式化改进

• 改进了带类型throws的do语句的换行处理
• 优化了带属性的宏声明的格式化
• 支持多行字符串字面量根据行长度自动换行
• 修复了嵌套IfConfig声明中的换行问题
• 改进了块注释的重新缩进支持

4. 配置选项增强

• 新增选项自定义"//"注释前的空格数量
• 添加选项控制相邻属性之间是否添加换行
• 新增配置保留仅包含空白字符的行的原始空白
• 支持通过--enable-experimental-feature启用实验性解析器特性

5. 平台兼容性提升

• 改进了Windows平台的兼容性
• 修复了Linux平台上的配置文件搜索问题
• 支持在根目录("/")下运行文件迭代器
• 完善了符号链接处理逻辑

开发者体验改进

1. 命令行工具增强

• 新增--assume-filename选项：从stdin读取时指定用于查找配置文件的假设文件名
• 逐步弃用不带输入路径运行swift-format的方式，未来将通过"-"明确表示从stdin读取

2. 测试与质量保证

• 将测试从swift-formatTests迁移到SwiftFormatTests
• 添加了健全性检查(soundness check)
• 改进了Windows平台上的测试支持
• 在发布前增加了Windows测试环节

3. 文档完善

• 修复了文档中的错误链接
• 补充了缺失的配置文档
• 记录了默认配置值
• 更新了README使其更具平台通用性

构建系统改进

• 支持使用SwiftPM构建工具链
• 支持仅构建测试
• 支持针对单个动态swift-syntax库构建
• 移除了Package.swift中的重复依赖项
• 更新了构建脚本以通过flake8检查

总结

Swift-Format 601.0.0版本带来了全方位的改进，从核心格式化功能到开发者体验都有显著提升。性能优化使得工具更加高效，新规则和格式化改进让代码风格更加一致，平台兼容性增强则扩大了工具的适用范围。对于Swift开发者而言，升级到这个版本将获得更流畅、更可靠的代码格式化体验。