sourcekit-lsp 启动后立即退出说明语言服务器未正常运行，需先验证命令是否存在、路径是否正确、工具链是否匹配，并确保通过文件夹方式打开含 package.swift 的 swiftpm 项目。
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 原生不支持，必须走 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/... 或 /Users/xxx/.../sourcekit-lsp。
更关键的是：VSCode 在 WSL2 或非标准路径下，几乎从不自动继承 shell 的 $PATH。即使你在 ~/.bashrc 里加了路径，VSCode 启动时也大概率看不到。所以：
- 打开设置（
Cmd+,/Ctrl+,），搜swift.path.sourceKitLSP，手动粘贴完整路径 - 改完后重启 VSCode，不要只重载窗口
- 顺手关掉
Editor: Suggest: Snippets Prevent Quick Suggestions，否则补全会卡死
打开 .swift 文件后右下角不显示 “SourceKit-LSP Active”
这通常不是插件问题，而是项目结构不对。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 版本与工具链一致——版本错位是静默崩溃最隐蔽的诱因。
