答案是安装并配置SwiftFormat工具。需通过Homebrew安装SwiftFormat，再在VSCode中安装sven-k.w.的“Swift”扩展，接着在设置中指定SwiftFormat完整绝对路径（如/opt/homebrew/bin/swiftformat），启用formatOnSave，并确保工作区根目录含.swiftformat配置文件。
VSCode 本身不带 Swift 格式化能力，必须靠外部工具 + 扩展协同工作；直接装个插件点保存就自动对齐缩进、换行、空格——这事在 Swift 里不会发生。
SwiftFormat 路径配错是最常见的“格式化失灵”原因
VSCode 的 Swift 扩展（sven-k.w. 版）只负责调用，真正干活的是你本地的 swiftformat 可执行文件。如果路径填错，按 Shift+Option+F 或启用 editor.formatOnSave 都会静默失败，连报错都不给。
- 用终端确认路径：
which swiftformat—— M1/M2 Mac 通常是/opt/homebrew/bin/swiftformat，Intel Mac 是/usr/local/bin/swiftformat - 在 VSCode 设置中搜
swiftformat path，填入上面输出的**完整绝对路径**，不能写~或省略/bin/ - 别信某些教程说“填
swiftformat就行”，VSCode 不走$PATH查找，必须写死全路径 - 改完设置后，重启 VSCode 或重载窗口（
Cmd+Shift+P→Developer: Reload Window），否则不生效
格式化快捷键没反应？先看语言模式和扩展状态
按下 Shift+Option+F 没反应，90% 是因为 VSCode 根本没把当前文件当 Swift 处理。
- 右下角状态栏检查语言模式：必须显示
Swift，不是Plain Text或Objective-C；点它可手动切换 - 确保已安装
Swift扩展（作者 sven-k.w.），且没被禁用；其他 Swift 相关扩展（如 SwiftLint）不提供格式化功能 -
Swift扩展依赖sourcekit-lsp提供基础语言服务，但格式化本身不走 LSP，所以即使sourcekit-lsp启动失败，只要swiftformat路径对，格式化仍能用
保存时自动格式化但部分文件被跳过？检查文件关联和排除规则
设置了 editor.formatOnSave: true 却只对 .swift 文件生效，Package.swift 或脚本类 Swift 文件没反应，是因为默认只绑定到 swift 语言标识。
- 在
settings.json中显式为非标准文件扩展加格式化支持：
"[swift]": {
"editor.defaultFormatter": "sven-k.w.swift"
},
"files.associations": {
"Package.swift": "swift",
"build-script.swift": "swift"
}
- 检查工作区或用户设置里有没有
files.exclude或search.exclude把.swift文件误排除了 -
SwiftFormat默认跳过注释过多、含不可解析语法（如未闭合泛型）的文件，这类情况不会报错，只会跳过——建议先用swiftformat --dryrun --verbose 文件名.swift在终端手动试跑，看是否输出Skipped
Swift 格式化链路短但脆弱：VSCode → Swift 扩展 → 全路径调用 swiftformat → 读取项目根目录下的 .swiftformat 配置。任何一环断开，就退回“手动删空格”时代。最容易被忽略的是：.swiftformat 配置文件必须放在你打开的 VSCode 工作区根目录，而不是用户主目录或 Xcode 项目目录里——它不跨目录继承。
