sublime text 仅支持 swift 语法高亮、基础构建触发和极简补全，无编译器、不解析 package.swift、无法跳转定义、不支持 swiftui 预览或调试；所谓“配置”实为让其识别 .swift 文件并调用系统已安装的 swiftc/swift 命令，正确显示错误位置。
Sublime Text 本身不提供 Swift 开发环境，只支持语法高亮、基础构建触发和极简补全——它没有编译器、不解析 Package.swift、无法跳转定义、不支持 SwiftUI 预览，更不能调试或打包。所谓“配置 Swift 环境”，本质是让 Sublime 能识别 .swift 文件、调用你系统里已装好的 swiftc 或 swift 命令，并正确显示错误位置。
Swift 语法高亮不生效：右下角没显示 “Swift”
这是最常见起点问题，不是插件没装，而是语言绑定没落定：
- 确认已通过 Package Control 安装了官方维护的
Swift插件（作者 kateinoigakari 或 sbrickey，别选名字带 “Swift” 但无人维护的冷门包） - 安装后必须重启 Sublime Text，否则
View → Syntax菜单里不会出现 Swift 选项 - 新建
main.swift，手动点右下角语言名 → 选Swift；再立刻点View → Syntax → Open all with current extension as…→ 再选一次Swift，否则下次新建同名文件仍回落为 Plain Text - 若仍无效，检查文件编码：菜单
File → Reopen with Encoding → UTF-8（**必须无 BOM**，BOM 会让语法解析器直接放弃）
Ctrl+B 报错 “Unable to find command 'swift'”
这不是 Sublime 的 bug，是 GUI 应用启动时根本没加载你的 shell $PATH。终端里能跑 swift --version，不代表 Sublime 能找到它：
- 在终端执行
which swift或which swiftc，记下完整路径，例如：/Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/swift - 打开
Tools → Build System → New Build System…，粘贴以下内容并保存为Swift.sublime-build（路径：Packages/User/）：
{
"cmd": ["/Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/swift", "$file"],
"file_regex": "^(.*?):([0-9]+):([0-9]+): (?:error|warning): (.*)$",
"selector": "source.swift",
"shell": true,
"working_dir": "$file_path"
}
-
"shell": true必须保留，否则$file变量不展开 - 不要用
"path"字段试图修复 PATH —— 它在新版 Sublime 中已被弃用且不可靠 - 顺手在终端验证：
swift --version和swiftc --version都得成功，因为不同构建系统可能调用其中任一命令
写 SwiftUI 却没补全、没跳转、Preview 不渲染
这完全正常，而且无法解决：
- Sublime 没集成 SourceKit-LSP，也不读取
Package.swift或 Xcode 项目结构，所有“补全”仅来自静态代码片段（snippets），对@State、ViewBuilder、PreviewProvider这类依赖编译期语义的语法毫无意义 - 别装 EasyClangComplete 或硬配
sourcekit-lsp：Sublime 的 LSP 支持极弱，官方文档已明确不推荐用于 Swift - 如果你真需要补全和跳转，唯一可行路径是换用 VS Code + Swift Extension（基于 sourcekit-lsp），或坚持用 Xcode —— Sublime 在这里只是个带高亮的记事本
真正容易被忽略的是：Swift 构建系统默认只编译，不运行；即便编译成功，也不会自动输出结果到 Sublime 控制台。想看到 print("hello") 的输出，得手动加执行步骤，或者改用 swift run（仅适用于有 Package.swift 的项目）。单文件开发中，最稳的做法仍是终端里 swift main.swift —— Sublime 的角色，始终只是帮你写得更清楚一点。
