swift-format for Mac 版
用于 Swift 源代码的格式化技术
swift-format 是什么
swift-format 是 SourceKit-LSP 背后的格式化技术,也是进行代码格式转换的基础构件。它既可以作为命令行工具使用,也能以 Swift Package Manager 依赖的形式链接进其他应用,通过 API 调用。
需要说明的是,目前还没有官方提出的默认 Swift 代码风格指南。swift-format 当前采用的风格只是众多可能方案中的一种,代码公开出来是为了能在真实项目上测试,也方便通过修改它来做各种实验。
从 Swift 5.8 起,swift-format 依赖的 SwiftSyntax 解析器已用 Swift 重写,不再依赖 Swift 工具链中的库。这让它可以被任何能编译它的 Swift 版本构建和运行,与特定语法版本解耦;不过旧版本的 swift-format 仍无法识别后续语言和解析器新增的语法。版本号方案也随之改为与 SwiftSyntax 一致,5.8 版是 508.0.0。对于 Swift 5.7 及更早版本,则需选用与所装 Swift 工具链主次版本号匹配的 swift-format 发布标签。
如果你只是想用它而非开发它,获取途径包括:Swift 6(Xcode 16 自带)及以上工具链已内置,可在系统任意位置通过 `swift format` 运行;也可通过 Homebrew 执行 `brew install swift-format` 安装。它适合需要统一 Swift 代码格式的开发者,以及想把格式化能力集成进自己工具的团队。
需要说明的是,目前还没有官方提出的默认 Swift 代码风格指南。swift-format 当前采用的风格只是众多可能方案中的一种,代码公开出来是为了能在真实项目上测试,也方便通过修改它来做各种实验。
从 Swift 5.8 起,swift-format 依赖的 SwiftSyntax 解析器已用 Swift 重写,不再依赖 Swift 工具链中的库。这让它可以被任何能编译它的 Swift 版本构建和运行,与特定语法版本解耦;不过旧版本的 swift-format 仍无法识别后续语言和解析器新增的语法。版本号方案也随之改为与 SwiftSyntax 一致,5.8 版是 508.0.0。对于 Swift 5.7 及更早版本,则需选用与所装 Swift 工具链主次版本号匹配的 swift-format 发布标签。
如果你只是想用它而非开发它,获取途径包括:Swift 6(Xcode 16 自带)及以上工具链已内置,可在系统任意位置通过 `swift format` 运行;也可通过 Homebrew 执行 `brew install swift-format` 安装。它适合需要统一 Swift 代码格式的开发者,以及想把格式化能力集成进自己工具的团队。
如何安装 swift-format
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-09-16,当前版本 604.0.0,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| 604.0.0 | 2026-09-16 | 稳定版 | — | — | — | — |
| 603.0.0 | 2026-06-30 | 稳定版 | — | — | — | — |
| 602.0.0 | 2025-09-16 | 稳定版 | — | — | — | — |
| 603.0.0-prerelease-2026-06-30 | 2026-06-30 | 预发布 | — | — | — | — |
| 603.0.0-prerelease-2026-02-09 | 2026-02-09 | 预发布 | — | — | — | — |
| 603.0.0-prerelease-2025-12-17 | 2025-12-17 | 预发布 | — | — | — | — |
| 604.0.0-prerelease-2025-12-17 | 2025-12-17 | 预发布 | — | — | — | — |
| 603.0.0-prerelease-2025-09-15 | 2025-09-16 | 预发布 | — | — | — | — |
| 603.0.0-prerelease-2025-08-11 | 2025-08-11 | 预发布 | — | — | — | — |
| 602.0.0-prerelease-2025-08-11 | 2025-08-11 | 预发布 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Linux · ARM64
- Linux · x86_64
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| swift-format | 604.0.0 | Apache-2.0 | 命令行 | 2,220 |
| tfsec | v1.28.14 | MIT | 命令行 | 2,267 |
| git-format-staged | v4.0.2 | MIT | 命令行 | 1,491 |
| swiftgen | 6.6.3 | MIT | 命令行 | 3,734 |