Sublime Text 中 Swift 编译失败主因是环境未正确配置：swiftc 未安装或不在 PATH 中、未显式链接 Foundation 框架、构建系统未加载 shell 配置导致路径不可见、缺少 SDK 路径或执行步骤，需逐项排查并手动指定 path、-framework、-sdk 及运行命令。
Swift 编译系统在 Sublime Text 里根本跑不起来？先确认你有没有 swiftc
Sublime 本身不带编译能力，它只是调用系统命令。如果你执行构建时看到 Unable to find command swiftc 或者 command not found: swiftc，说明 Sublime 根本找不到 Swift 编译器——不是配置错了，是环境压根没装好。
检查方法很简单，在终端里运行：
which swiftc
如果返回空，就得先装 Swift 工具链（macOS 用户建议用 xcode-select --install 或完整安装 Xcode；Linux 用户按官方指南装 swift-lang 包）。
-
swiftc必须在系统$PATH里，Sublime 的构建系统默认不读 shell 的 profile，所以即使你在 iTerm 里能跑，Sublime 可能还是找不到 - macOS 上用 Homebrew 装的 Swift（比如通过
swiftenv）要额外把路径加进 Sublime 的PATH环境变量（见下一条） - 别信“装了 Xcode 就一定有”，Xcode 14+ 默认不自带命令行工具，必须手动安装
Build System 配置里 PATH 写不对，swiftc 就是找不着
Sublime 的构建系统默认继承的是登录环境的 PATH，但 GUI 应用（包括 Sublime）启动时往往没加载 ~/.zshrc 或 ~/.bash_profile，所以你终端里能用的 swiftc，Sublime 就看不见。
解决办法：在构建系统文件里显式指定 path：
{
"cmd": ["swiftc", "-o", "${file_base_name}", "${file}"],
"file_regex": "^(.*?):([0-9]+):([0-9]+): (error|warning): (.*)$",
"selector": "source.swift",
"path": "/usr/bin:/opt/homebrew/bin:/opt/swift/bin"
}
-
path值是冒号分隔（macOS/Linux），不是分号；Windows 用分号，但 Swift 基本不用 Windows 开发 - 常见 Swift 安装路径：
/usr/bin（Xcode 自带）、/opt/homebrew/bin（Homebrew）、/opt/swift/bin（官网下载包） - 别写成
"path": "$PATH"—— Sublime 不解析 shell 变量
swiftc 编译单文件没问题，但一碰 import Foundation 就报错
这是典型链接失败：swiftc 默认只编译，不链接 Foundation 框架。macOS 上 Foundation 是系统框架，需要显式告诉编译器去连。
构建命令得加 -framework Foundation 和 -sdk 参数：
"cmd": ["swiftc", "-framework", "Foundation", "-sdk", "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk", "-o", "${file_base_name}", "${file}"]
-
-sdk路径必须存在，Xcode 版本升级后路径可能变（比如MacOSX14.2.sdk），用xcode-select -p查 Xcode 路径，再进对应目录确认 SDK 名 - 如果只是写纯算法、不涉及 IO 或字符串处理，可以先删掉
import Foundation测试是否真由它引发 - 想支持跨平台（Linux）？那就不能用 Foundation，得换
SwiftStdlib相关 API，而且构建系统要区分平台
运行结果一闪而过，根本看不到输出
Sublime 构建系统默认只显示编译过程，不自动运行生成的二进制。你得手动加 ./${file_base_name}，或者拆成两步：编译 + 执行。
更稳妥的做法是用 shell 包一层：
"cmd": ["sh", "-c", "swiftc -o ${file_base_name} ${file} && ./${file_base_name}"]
- 这样编译失败就不会执行，避免运行旧二进制导致误判
- 如果程序需要输入，Sublime 的输出面板不支持交互式 stdin，会卡住；这种场景老老实实回终端跑
- 想看详细错误堆栈？加
-Xswiftc -debug或用swift build（但那就不是单文件构建了）
真正麻烦的从来不是写几行 JSON 配置，而是 Swift 在不同环境下对 SDK、Framework、PATH 的隐式依赖——这些地方漏一个，构建就静默失败，连报错都懒得给你。
