swift-format GitHub 操作

主要观点:swift-format是 Swift 语言格式化工具的选项之一,由 Apple 构建且是官方 Swift GitHub 组织的一部分,很可能成为主要工具。Xcode 16 中它作为 CLI 工具和工具栏动作与 Apple 的 Swift 开发 IDE 捆绑。
关键信息:

  • 可直接在 macOS 15 容器中通过xcrun swift-format运行,工作流示例可添加到项目的.github/workflows/目录下。
  • Xcode 16 不支持保存时自动格式化,但提供手动格式化当前文件的工具栏菜单和快捷键(Ctrl+Shift+I),也可通过 CLI 工具格式化整个项目。
  • 项目根目录的.swift-format配置文件会被尊重,可参考xcrun swift-format dump-configuration的默认设置进行自定义,作者有自己的配置文件并需在项目间复制同步。
    重要细节:
  • 工作流示例中swift-format lint会并行检查所有文件,有警告则步骤失败。
  • swift-format format默认子命令可格式化多数内容,但仍有swift-format lint的警告,可在工作流中结合使用两个命令。
  • 有一个开放的 Pull Request来添加支持XDG_CONFIG_HOME和全局配置的功能。
阅读 24
0 条评论