sourcekit-lsp 启动后立即退出，VSCode 里没补全也没跳转
导致这一问题的根本原因其实非常直接——语言服务器根本没有成功启动，并非运行缓慢，而是完全无法建立连接。VSCode 中的 Swift 插件（例如 sschmid.Swift）本身并不提供代码补全或跳转服务，它们仅负责将请求转发给后台进程。一旦 sourcekit-lsp 崩溃或退出，编辑器就会退化为纯文本工具，所有智能提示、跳转定义功能都会消失。
无需急于调整 VSCode 配置，建议先在终端中执行一条命令：sourcekit-lsp --help。如果返回 command not found，说明要么未安装，要么系统路径配置有误。如果能正常输出帮助信息，则还需进一步排查以下几个关键点：
- 确认当前正在使用的工具链版本与
swift --version输出的版本完全一致——无论是 Xcode 自带、Homebrew 安装，还是从 swift.org 下载的独立包，必须保持对齐。 - macOS 上如果使用的是 Xcode 工具链，请务必先执行
sudo xcode-select -s /Applications/Xcode.app，否则系统可能无法定位到正确的可执行文件路径。 - Linux/WSL2 用户需要检查
/opt/swift/usr/bin/sourcekit-lsp是否具备可执行权限，缺少权限会导致无法启动，通过chmod +x手动授予即可解决。 - Windows 原生环境下无法直接运行 sourcekit-lsp，必须通过 WSL2 使用，并且 VSCode 需要借助
Remote - WSL扩展来打开项目，否则路径映射会完全混乱。
VSCode 设置里填了 swift.path.sourceKitLSP 却还是失效
填写了配置项并不代表它已生效——其中隐藏着不少暗坑。路径错误、环境变量未被继承、VSCode 未能读取到设置，都可能导致配置形同虚设。
首先，swift.path.sourceKitLSP 的值必须使用绝对路径，不能包含 ~ 符号，也不能有空格或中文字符。举例来说，正确的写法是 /Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/sourcekit-lsp，而不是 ~/Library/... 或带空格的路径。
更隐蔽的问题在于：VSCode 在 WSL2 或非标准路径环境下，几乎不会自动继承 shell 的 $PATH 环境变量。即使你在 ~/.bashrc 中设置了路径，VSCode 启动时也大概率无法读取到。因此，必须执行以下操作：
- 打开设置（
Cmd+,/Ctrl+,），搜索swift.path.sourceKitLSP，手动粘贴完整的绝对路径。 - 修改后务必彻底重启 VSCode，仅重载窗口是不够的。
- 顺带关闭
Editor: Suggest: Snippets Prevent Quick Suggestions选项，否则代码补全可能会卡住无法正常显示。
打开 .swift 文件后右下角不显示 “SourceKit-LSP Active”
这个问题通常不是插件存在 Bug，而是项目结构不符合要求。VSCode 的 Swift 插件仅识别 SwiftPM 的元数据，对 .xcodeproj、.swiftpm 甚至单个 main.swift 文件都不予支持。
如果你直接双击打开一个 .swift 文件，sourcekit-lsp 会因为找不到 Package.swift 而默默退出，终端日志中会留下 no workspace 或 unable to resolve package 的错误信息。
正确的做法是：使用 File > Open Folder 打开包含 Package.swift 的根目录。如果项目尚未初始化，可以在终端中进入空目录并执行：
swift package init --type=executable
生成标准项目结构后，再通过文件夹方式打开。首次加载时右下角会出现 “Building workspace”，这是 swift build --generate-diagnostics 在后台进行索引——请耐心等待它完成，之后符号跳转和代码补全才能正常生效。
sourcekit-lsp 偶发崩溃，频繁重启或诊断延迟
这种情况大概率不是配置问题，而是资源消耗或项目规模导致的稳定性隐患。大型 Swift 项目（尤其是依赖多、跨平台模块复杂的项目）会显著推高 sourcekit-lsp 的内存占用，macOS 的 watchdog 可能会直接终止进程，WSL2 中则可能被 OOM killer 强制结束。
临时缓解措施可以尝试以下三种方案：
- 在项目根目录的
.vscode/settings.json中添加配置："swift.sourceKitLSP.args": ["--memory-limit", "4096"]（部分版本支持此参数）。 - 避免同时打开多个 Swift 工作区——每个工作区都会独立启动一个
sourcekit-lsp实例，资源竞争会非常严重。 - 关闭那些非必要的扩展，尤其是 Python、ESLint 等语言服务插件，它们与
sourcekit-lsp共享主线程资源，容易相互拖累导致性能下降。
若要从根本上解决问题，还是需要确保 sourcekit-lsp 与 swift 命令指向同一套工具链，同时保证 Package.swift 中声明的 Swift 版本与工具链完全一致——版本不匹配是导致静默崩溃的最隐蔽诱因，排查起来相当棘手。
