Sublime Text 无法运行 Swift 项目，仅能通过绝对路径调用系统 swift 命令执行单文件脚本；根本原因是 macOS GUI 应用不加载 shell 配置文件导致 PATH 不可见，需手动配置 .sublime-build 并正确设置 file_regex、shell 和语法高亮。
Sublime Text 不能运行 Swift 项目，也不能调试、预览或构建 App；它唯一能做的，是调用你系统里已装好的 swift 或 swiftc 命令来解释执行单个 .swift 文件——前提是路径写死、shell 开启、file_regex 匹配正确，否则 Ctrl+B 一按就报 command not found: swift。
为什么终端能跑 swift --version，Sublime 却找不到命令
macOS 的 GUI 应用（包括 Sublime Text）启动时不加载 ~/.zshrc 或 ~/.bash_profile，所以你的 $PATH 对它不可见。这不是插件问题，也不是 Sublime 故意搞事，是系统级环境隔离。
- 别信终端里
which swift的输出在 Sublime 里一定有效——GUI 进程里它可能为空 - 必须用绝对路径：
/usr/bin/swift（Xcode 自带）、/opt/homebrew/bin/swift（Homebrew 安装）、或/Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/swift（Swift.org 官方包） - 如果装了 Xcode 但没点过“同意许可协议”，
swiftc会静默失败；先在终端运行xcodebuild -runFirstLaunch
怎么写一个真正能跑的 Swift.sublime-build
只适用于单文件脚本（比如算法验证、CLI 工具原型），不支持 import Foundation 等模块，除非显式加 SDK 参数。
- 最简解释执行（推荐 Swift 5.9+）：
{ "cmd": ["/opt/homebrew/bin/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" } -
"shell": true必须设为true，否则$file、$file_path这类变量根本不会展开 -
file_regex必须严格匹配 Swift CLI 实际错误输出格式，否则双击错误行无法跳转到对应位置
右下角不显示 Swift？高亮失效的三个硬伤
不是插件没装，而是卡在三处低级但致命的位置：
- 装错插件：认准官方维护的
Swift（作者kateinoigakari），别选Swift IDE或冷门包 - 没重启 Sublime：菜单
Sublime Text → Quit Sublime Text再重开，否则插件注册不完整 - 语法没手动设置：打开
.swift文件 → 右下角点击当前语法名（如Plain Text）→ 选择Swift；检查Preferences > Settings – Syntax Specific是否误加了覆盖项
最容易被忽略的是：Swift 脚本里用 #!/usr/bin/swift 在现代 macOS 上基本失效——自 Xcode 12 起，系统不再预装该路径；改用 #!/usr/bin/env swift 并确保 which swift 有输出，同时必须 chmod +x script.swift，否则连终端执行都报 Permission denied。
