sublime text 需配置自定义构建系统才能运行 swift：先确认系统已安装 swift 工具链（which swiftc、swift --version），再创建 swift.sublime-build 文件，内含 swiftc 编译与执行命令，并适配路径、编码及环境变量。
Sublime Text 本身不原生支持 Swift 编译与运行，必须通过插件和外部工具链协同完成；直接双击运行 .swift 文件会失败，核心原因是缺少构建系统（Build System）配置和正确的 swiftc 路径识别。
确认本地已安装 Swift 工具链
Sublime 不自带编译器，一切依赖系统级 Swift 环境。macOS 用户通常随 Xcode Command Line Tools 或 Swift.org 官方包安装 swiftc，需先验证是否可用：
- 终端执行
which swiftc，应返回类似/usr/bin/swiftc或/opt/homebrew/bin/swiftc的路径 - 若提示 command not found，请先安装 Xcode CLT：
xcode-select --install，或从 swift.org/download 下载对应平台的开发包 - 运行
swift --version确保输出版本号（如Apple Swift version 5.9），避免因旧版缺失swift run等特性导致构建失败
配置 Sublime 的 Swift 构建系统
Sublime 用 JSON 格式的构建系统（.sublime-build）调用命令行工具。不建议用 Package Control 搜索“Swift”插件——多数已过时或仅提供语法高亮，无法真正运行代码。
- 菜单栏选择 Tools → Build System → New Build System…
- 替换全部内容为以下配置（适配 macOS 默认路径；若
swiftc在其他位置，请修改"cmd"中的路径）：
{
"shell_cmd": "swiftc -o \"${file_path}/${file_base_name}\" \"${file}\" && \"${file_path}/${file_base_name}\"",
"file_regex": "^(...*?):([0-9]*):([0-9]*):? ?(.*)$",
"selector": "source.swift",
"variants": [
{
"name": "Run",
"shell_cmd": "swift run --repl \"${file}\" 2>/dev/null || swiftc -o \"${file_path}/${file_base_name}\" \"${file}\" && \"${file_path}/${file_base_name}\""
}
]
}
- 保存为
Swift.sublime-build（自动存入~/Library/Application Support/Sublime Text/Packages/User/） - 关键点：
"shell_cmd"分两步：先编译（swiftc），再执行生成的二进制；"variants"提供Ctrl+Shift+B选 Run 快速运行，避免手动切换 - Windows / Linux 用户需将
swiftc改为完整路径（如/home/user/swift/usr/bin/swiftc），且注意可执行文件后缀（Windows 为.exe）
处理常见错误现象
即使配置完成，实际运行仍可能报错，多数源于路径、权限或 Swift 版本行为差异：
-
env: python: No such file or directory：某些老构建脚本硬编码调用python，但 macOS 12.3+ 已移除预装 Python 2。解决方法是删掉构建系统里所有含python的行，或改用纯 shell 方案（如上例） - 输出中文乱码（尤其在
print("你好")时）：Sublime 默认使用系统 locale 启动子进程，macOS 终端常设为UTF-8，但 Sublime 可能未继承。可在构建系统中加"env": {"LANG": "en_US.UTF-8", "LC_ALL": "en_US.UTF-8"} - 编译成功但运行无输出：检查是否误用了
swift build（需 Package.swift）；单文件场景必须用swiftc编译，而非swift run（后者仅对 SwiftPM 项目有效） - 提示
error: unable to invoke subcommand: swift-build (No such file or directory)：说明构建系统错误引用了 SwiftPM 命令，应彻底删除相关字段
真正卡住的地方往往不是配置本身，而是 Sublime 启动时没加载到当前 shell 的 PATH（比如用 zsh 配置了 swiftc 别名，但 Sublime 以 bash 启动）。最稳的方式永远是写死 swiftc 绝对路径，并用 which swiftc 实时校验。
