Sublime Text 不能用于苹果平台完整开发，仅可编写纯 Swift 脚本或辅助 Xcode 编辑；它无编译、调试、预览能力，所有“配置”实为绕过其能力边界，依赖终端与系统工具链。
Sublime Text 不能用于苹果平台（iOS/macOS）的完整开发，包括 SwiftUI、UIKit、AppKit、Vapor 或 Swift Concurrency 项目——它连编译都做不到，更别说调试、预览、签名、模拟器或运行时集成。 它只适合写纯 Swift 脚本、练习语法、整理逻辑片段，或作为 Xcode 的轻量辅助编辑器。所有“配置环境”的动作，本质都是在绕过 Sublime 的能力边界，把活儿甩给终端和系统工具链。
为什么 Build 系统总报 command not found: swift 或 Unable to find a build system
GUI 启动的 Sublime 不会自动加载 shell 的 $PATH（尤其是 zsh 的 ~/.zshrc），即使你在终端里能跑 swift --version，Sublime 也大概率找不到命令。
- 不要依赖
which swift输出——它在 GUI 进程里可能为空；必须用绝对路径，比如/usr/bin/swift（macOS 自带）、/Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/swift（Swift.org 官方包）或~/swift/usr/bin/swift（Linux 手动解压路径） - 检查 Xcode 许可协议是否已接受：没运行过
xcodebuild -runFirstLaunch或没手动打开 Xcode 点过“同意”，swiftc会静默失败 -
"shell": true必须设为true，否则$file、$file_path这类变量不会展开
怎么写一个真正能跑的 Swift Build System（单文件脚本场景）
只适用于写算法、验证语法、跑简单 CLI 工具——不是 App，不是 Package，不是 Vapor 项目。
- 最简配置（直接解释执行）：
{ "cmd": ["swift", "$file"], "file_regex": "^([^:]*):([0-9]+):([0-9]+): (?:error|warning|note): (.*)$", "selector": "source.swift", "shell": true, "working_dir": "$file_path" }注意：file_regex必须匹配 Swift CLI 的错误格式，否则双击错误不跳转 - 如果要用
swiftc编译再运行（例如需要链接 C 库），得显式处理可执行权限：{ "cmd": ["bash", "-c", "swiftc '$file' -o '${file_path}/${file_base_name}' && chmod +x '${file_path}/${file_base_name}' && '${file_path}/${file_base_name}'"], "selector": "source.swift", "shell": true, "working_dir": "$file_path" }缺chmod +x会导致permission denied
语法高亮和补全到底能到什么程度
Sublime 自带的 Swift.sublime-syntax 能做基础高亮、括号匹配、缩进和 snippet 展开（如 struct → struct Name { }），但没有语义级补全：不会提示函数参数、不会显示类型、不会跳转定义、hover 不出文档。
- 别装
SourceKit-LSP或sublimelsp——Swift 的 LSP 实现（sourcekit-lsp）与 Sublime 兼容性极差，常见 connection closed、索引失败、hover 延迟数秒 - Package Control 里搜
Swift，装Swift Language（kateinoigakari）就够了；其他“Swift IDE”“SwiftImproved”插件多为过时维护，反而干扰语法识别 - 补全靠
Ctrl+Space触发原生单词联想，或手动写 snippet；别指望它像 VS Code 那样弹出fetchData(_:timeout:)的完整签名
真正容易被忽略的点是：你写的每一个 @MainActor、actor Counter、await 表达式，在 Sublime 里都不会被校验。它不会告诉你 counter.value 访问非法，也不会标红 async 函数里漏了 await。这些只能靠 Xcode 编译时发现——Sublime 只负责让你打得快，不负责让你写得对。
