# SwiftFormat for Xcode

用于从 Xcode 的 Editor 菜单重新格式化 Swift 代码的源代码编辑器扩展。

> 这是 OpenNavo 上 SwiftFormat for Xcode 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/swiftformat-for-xcode>

- **最新版本**: `0.64.7`
- **开发者**: Nick Lockwood
- **主页**: <https://github.com/nicklockwood/SwiftFormat>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask swiftformat-for-xcode`
- **近 30 天安装**: 323
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://github.com/nicklockwood/SwiftFormat/releases/download/0.64.7/SwiftFormat.for.Xcode.app.zip>
- **SHA-256**: `448ceafb4f3fffcc180bb93fef7e447b2b559c63141388090caa71350ba95e31`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "SwiftFormat for Xcode.app"
      ],
      "target": "/Applications/SwiftFormat for Xcode.app"
    },
    "phase": "install",
    "sources": [
      "SwiftFormat for Xcode.app"
    ],
    "target": "/Applications/SwiftFormat for Xcode.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Scripts/com.charcoaldesign.SwiftFormat-for-Xcode",
            "~/Library/Application Scripts/com.charcoaldesign.SwiftFormat-for-Xcode.SourceEditorExtension",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.charcoaldesign.swiftformat-for-xcode.sfl*",
            "~/Library/Containers/com.charcoaldesign.SwiftFormat-for-Xcode",
            "~/Library/Group Containers/com.charcoaldesign.SwiftFormat"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

SwiftFormat for Xcode 是一款 macOS 应用，提供用于在 Xcode 中重新格式化 Swift 代码的源代码编辑器扩展。启动应用并重新启动 Xcode 后，可从 Xcode 的 Editor 菜单调用 SwiftFormat。

该扩展应用 SwiftFormat 的代码格式规则，可调整空白字符，也可处理隐式 `self`、多余括号等代码风格问题。格式规则和选项在宿主应用中设置。配置可以导入或导出，但不能按项目单独覆盖；切换项目时，需要导入所需配置。导入的 `.swiftformat` 文件发生更改后，也必须手动重新导入。

安装时运行 `brew install --cask swiftformat-for-xcode`，然后从“应用程序”中打开 SwiftFormat for Xcode，按屏幕提示操作并重新启动 Xcode。此 cask 安装的是 Xcode 扩展应用，不是独立的 `swiftformat` 命令行软件包。

[官方项目与设置指南](https://github.com/nicklockwood/SwiftFormat)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 0.64.7 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 核查于 2026-11-22
  - <https://github.com/nicklockwood/SwiftFormat/releases/download/0.64.7/SwiftFormat.for.Xcode.app.zip>
  - SHA-256: `448ceafb4f3fffcc180bb93fef7e447b2b559c63141388090caa71350ba95e31`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 0.64.7 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 核查于 2026-11-22
  - <https://github.com/nicklockwood/SwiftFormat/releases/download/0.64.7/SwiftFormat.for.Xcode.app.zip>
  - SHA-256: `448ceafb4f3fffcc180bb93fef7e447b2b559c63141388090caa71350ba95e31`

## SwiftFormat for Xcode 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/nicklockwood/SwiftFormat> · 是否开源: 是 — <https://github.com/nicklockwood/SwiftFormat> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask swiftformat-for-xcode`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask swiftformat-for-xcode`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Scripts/com.charcoaldesign.SwiftFormat-for-Xcode` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Scripts/com.charcoaldesign.SwiftFormat-for-Xcode.SourceEditorExtension` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.charcoaldesign.swiftformat-for-xcode.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Containers/com.charcoaldesign.SwiftFormat-for-Xcode` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Group Containers/com.charcoaldesign.SwiftFormat` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 0.64.7 (2026-11-14)

SwiftFormat for Xcode 0.64.7 增加拼写选项，并修复会崩溃或错误改写 Swift 的规则。

SwiftFormat for Xcode 0.64.7 于 2026 年 11 月 14 日发布，为 commonTypos 增加拼写选项，并修复会崩溃或错误改写 Swift 代码的规则。来源：https://github.com/nicklockwood/SwiftFormat/releases/tag/0.64.7

- commonTypos 增加 --prefer-us-spelling 和 --preserve-iff。
- hoistTry 和 hoistAwait 不再在深层嵌套上无法结束。
- 负整数移位不再使词法分析器崩溃。
- preferKeyPath 不再在 #expect 和 #require 内生成无效代码。
- forWhere 在用 && 连接条件时不再改变运算符优先级。
- unusedArguments 不再在没有参数的生命周期属性上崩溃。

## 资料与来源

- <https://opennavo.com/zh/apps/swiftformat-for-xcode>
- <https://opennavo.com/zh/apps/swiftformat-for-xcode/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/swiftformat-for-xcode.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/swiftformat-for-xcode>
- <https://github.com/nicklockwood/SwiftFormat> · 核查于 2026-11-13
