Sublime Text 需手动配置 Swift 构建系统才能运行 .swift 文件，依赖系统已安装的 swift 命令行工具；需验证 swift --version 可用，配置正确的 .sublime-build 文件并处理路径、SDK、stdin 等常见问题。
Sublime Text 本身不支持直接编译运行 Swift，它只是一个文本编辑器，没有内置的 Swift 编译器或构建系统。你必须依赖系统已安装的 swift 命令行工具，并手动配置 Build System 才能让 .swift 文件在 Sublime 中一键运行。
确认系统已安装 Swift 工具链
Sublime 不会帮你装 Swift，所有编译能力来自终端可用的 swift 命令。macOS 用户通常随 Xcode Command Line Tools 或 Swift.org 官方包安装；Linux 需手动下载并配置 PATH。
- 在终端执行
swift --version，能正常输出版本号（如Swift 5.9）才算就绪 - 如果提示
command not found: swift，Sublime 配置再完善也跑不起来 - macOS 上仅安装 Xcode.app 不够，还需运行
xcode-select --install或在 Xcode > Preferences > Locations 中选中 Command Line Tools
创建自定义 Swift Build System
Sublime 用 .sublime-build 文件定义如何调用外部命令。Swift 最简构建只需执行 swift filename.swift，但要注意路径和工作目录问题。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 菜单栏选择 Tools → Build System → New Build System…
- 替换全部内容为以下 JSON（注意
shell_cmd中的引号和$file变量）：
{
"shell_cmd": "swift \"$file\"",
"file_regex": "^(.*?):([0-9]+):([0-9]+): (error|warning): (.*)$",
"selector": "source.swift",
"variants": [
{
"name": "Run",
"shell_cmd": "cd \"$file_path\" && swift \"$file_name\""
}
]
}
- 保存为
Swift.sublime-build（自动存到Packages/User/目录） -
file_regex让错误信息可点击跳转到对应行；selector确保新建 .swift 文件时自动匹配此构建系统 - 加了
variants是因为直接swift file.swift在含import Foundation的文件里可能因工作目录不对而找不到模块；cd到文件所在目录更稳妥
运行 Swift 时常见报错与应对
即使 Build System 写对了，实际运行仍可能失败，多数源于环境或代码本身问题，而非 Sublime 配置错误。
-
error: unable to invoke subcommand: swiftc (No such file or directory)：说明 Sublime 启动时没读到系统PATH，尤其常见于 macOS 使用 zsh 而 Sublime 由 GUI 启动。解决方法是用shell_cmd显式写全路径，例如/usr/bin/swift \"$file\"（先用which swift查准路径） -
error: missing required module 'Foundation'：不是缺 Framework，而是 Swift 运行时没加载到 SDK。确保 Xcode Command Line Tools 已正确选中，或在shell_cmd中添加xcrun --sdk macosx swift \"$file\" - 中文路径或文件名含空格导致构建失败：靠
"$file"双引号包裹已基本覆盖，但若仍出问题，可改用"$file_base_name"+cd "$file_path"组合规避
别指望 Sublime 提供 Swift IDE 功能
它没有类型推导、跳转定义、自动补全或调试器。虽然可通过插件（如 SublimeLinter-swiftc）做语法检查，但本质仍是“写完保存 → Ctrl+B 运行 → 看终端输出”。真正需要工程管理、断点调试或 Package Manager 支持，请用 VS Code（配合 swiftenv + Swift Syntax 插件）或 JetBrains AppCode。
最易被忽略的一点：Sublime 的构建系统默认不捕获 stdin，所以含 readLine() 的程序会立即退出。如需交互输入，得改用终端运行，或在 Build System 中调用 osascript 弹出 Terminal 窗口——这已经超出轻量编辑器的设计范畴了。
