先说结论：Sublime Text 在 macOS 上其实不能直接运行 Swift 项目。连跑单文件脚本，也得靠系统自带的终端工具链来“借力”。

它本身没有编译器库，不识别 Package.swift 里定义的那些依赖，也没有调试器。所谓“运行”，本质上只是悄悄调用系统里的 swift 或 swiftc。

为什么 Build 总报 command not found: swift

这个问题很典型，根因只有一个：通过 GUI 方式启动的 Sublime，不会加载你的 shell 配置。

哪怕你在终端里敲 swift --version 能正常输出，Sublime 里大概率还是找不到这个命令。

• 千万别信终端里 which swift 的输出。它在 Sublime 的 GUI 进程里很可能为空
• 解决方案只有一个：用绝对路径
  • macOS 自带的是 /usr/bin/swift
  • 如果装了 Swift.org 官方包，路径可能是 /Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/swift
  • 如果通过 Homebrew 安装，则是 /opt/homebrew/bin/swift
• 还有一件需要特别小心的事：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 Text 对 Swift 的支持边界其实很清晰。它能高亮、能跳转、能调命令行，但永远不知道 let x: Int 是 optional 还是 implicit unwrapped。

它也不会告诉你 async 函数该在哪里 await。别试图让它变成 Xcode，它只是在敲代码时顺手的那支笔。

《夸克》非常好用的免费AI浏览器

下载APP查看