Sublime Text 在 macOS 上无法运行 Swift 项目，仅能通过调用系统 swift/swiftc 工具链执行单文件脚本；报 command not found 根因是 GUI 进程不加载 shell 配置，须用绝对路径并设 "shell": true。
Sublime Text 在 macOS 上不能运行 Swift 项目，连单文件脚本都得靠终端工具链“借力”才能跑起来——它本身没有编译器、没有调试器、不认 Package.swift，所有“运行”动作本质是调用系统里的 swift 或 swiftc。
为什么 Build 总报 command not found: swift
GUI 启动的 Sublime 不会加载你的 shell 配置（比如 ~/.zshrc），即使终端里 swift --version 能成功，Sublime 也大概率找不到命令。
- 别信
which swift在终端的输出——它在 Sublime 的 GUI 进程里可能为空 - 必须用绝对路径：
/usr/bin/swift（macOS 自带）、/Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/swift（Swift.org 官方包）或/opt/homebrew/bin/swift（Homebrew 安装） - 检查 Xcode 许可协议是否已接受：没运行过
xcodebuild -runFirstLaunch，swiftc会静默失败 -
"shell": true必须设为true，否则$file、$file_path这类变量不会展开
怎么写一个真正能跑的 Swift Build System（单文件场景）
只适用于写算法、验证语法、跑 CLI 工具——不是 App，不是 Package，不是 SwiftUI 项目。
- 最简解释执行（推荐 Swift 5.9+）：
{ "cmd": ["swift", "$file"], "file_regex": "^([^:]*):([0-9]+):([0-9]+): (?:error|warning|note): (.*)$", "selector": "source.swift", "shell": true, "working_dir": "$file_path" } - 若需编译再运行（比如链接 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 -
file_regex必须匹配 Swift CLI 错误格式，否则双击错误行无法跳转
右下角不显示 Swift？高亮根本没生效
不是插件没装，而是三个低级但致命的问题卡住了：
- 装错插件：官方维护、持续更新的是
Swift（作者 kateinoigakari），别选Swift IDE或冷门包 - 没重启 Sublime：菜单
Sublime Text → Quit Sublime Text再重开，否则插件注册不完整 - 文件编码带 BOM：菜单
File → Reopen with Encoding → UTF-8（注意选“UTF-8”，不是“UTF-8 with BOM”）；BOM 会让整个.sublime-syntax解析器直接退出 - 要永久绑定
.swift后缀：先让当前文件右下角显示Swift，再点菜单View → Syntax → Open all with current extension as…，确认选中Swift
想用 Swift Package Manager？别硬套单文件配置
SPM 项目有结构依赖，swift build 和 swift run 必须在含 Package.swift 的根目录执行。
- 构建系统里
"working_dir": "$project_path"是关键，不能是$file_path - 正确配置示例：
{ "cmd": ["swift", "build", "--configuration", "debug"], "working_dir": "$project_path", "file_regex": "^(.*?):([0-9]+):([0-9]+): (error|warning): (.*)$", "selector": "source.swift", "variants": [ { "name": "Run", "cmd": ["swift", "run"] } ] } -
swift run默认跑第一个可执行 target；如需指定，写成["swift", "run", "MyServer"] - 确保项目结构标准：
Package.swift存在、Sources/MyApp/main.swift、products数组里声明了可执行目标
最常被忽略的一点：Sublime 对 Swift 的支持边界非常清晰——它能高亮、能跳转、能调命令行，但永远不知道 let x: Int? 是 optional 还是 implicit unwrapped，也不会告诉你 async 函数该在哪 await。别试图让它变 Xcode，它只是你敲代码时顺手的那支笔。
