sourcekit-lsp 未正确运行导致 VSCode Swift 功能失效；需确认其可执行、路径配置正确（如 Xcode 或 Homebrew 路径）、项目为 SwiftPM 根目录（含 Package.swift），并确保环境变量与工具链一致。
sourcekit-lsp 跑不起来，VSCode 就只是个高级文本编辑器
VSCode 的 Swift 插件（比如 sschmid.Swift）本身不带编译器或语言服务，它只负责把请求转发给系统级的 sourcekit-lsp 进程。这个进程一挂，补全、跳转、诊断全失效，只剩语法高亮。
先在终端执行：sourcekit-lsp --help
有帮助输出才说明二进制存在且可执行；报 command not found 就别调 VSCode 设置，先修 PATH 或路径本身。
- macOS 常见路径：
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/sourcekit-lsp（需先sudo xcode-select -s /Applications/Xcode.app） - Homebrew 安装：路径通常是
/opt/homebrew/bin/sourcekit-lsp - Linux/WSL2：解压官方包后通常在
/opt/swift/usr/bin/sourcekit-lsp，记得加进~/.bashrc的PATH并source ~/.bashrc - Windows 原生无
sourcekit-lsp—— 必须用 WSL2，且 VSCode 要通过Remote - WSL打开项目
VSCode 设置里必须手动填 swift.path.sourceKitLSP
VSCode 不会自动发现 sourcekit-lsp，尤其在 WSL2 或非标准安装路径下，环境变量继承不可靠，自动探测大概率失败。
打开设置（Cmd+, / Ctrl+,），搜 swift.path.sourceKitLSP，填绝对路径，例如：/opt/swift/usr/bin/sourcekit-lsp
- 别用
~代换，VSCode 解析可能出错 - 路径中不能有空格或中文
- 如果同时装了多个 Swift 工具链（比如 Xcode + 独立 toolchain），确保填的路径和你终端里
swift --version对应的那套一致 - 顺手关掉设置项
Editor: Suggest: Snippets Prevent Quick Suggestions，否则补全响应极慢甚至卡死
必须打开含 Package.swift 的 SwiftPM 根目录
sourcekit-lsp 启动后静默退出、提示 no workspace 或 unable to resolve package，90% 是因为你双击打开了单个 main.swift，而不是用 File > Open Folder 打开含 Package.swift 的文件夹。
- 终端进空目录，运行
swift package init --type=executable初始化标准结构 - VSCode 必须打开这个根目录（即包含
Package.swift、Sources/、Tests/） - 首次打开后右下角状态栏会显示 “Building workspace”，这是
swift build --generate-diagnostics在后台运行；等它完成，符号索引才真正可用 - 别指望
.xcodeproj或.swiftpm能被识别——Swift 插件只认 SwiftPM 元数据
运行代码不是点按钮，而是靠 swift run 或 tasks.json
VSCode 没有内置 Swift 运行按钮。“运行”本质是调用 swift run 编译并执行，它依赖完整的构建上下文（.build/debug/ 目录），而该目录只能由 SPM 在对应平台环境下生成。
- 最简方式：在 VSCode 集成终端（已处于 WSL2 或 macOS）中直接运行
swift run - 想快捷运行，可配
.vscode/tasks.json：{ "version": "2.0.0", "tasks": [ { "label": "run", "type": "shell", "command": "swift run", "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "shared", "showProblems": true } } ] } - 调试需额外配置
launch.json，program字段必须指向.build/debug/YourExecutable，不能是源码路径或swift run命令 - Linux 上还需确保
LD_LIBRARY_PATH包含 Swift 运行时路径，否则swift test会报unable to load standard library
真正卡住人的从来不是插件装没装，而是 sourcekit-lsp 进程有没有活下来、项目结构是不是被识别、以及 VSCode 启动时有没有拿到正确的环境变量——这三件事没对齐，所有功能都会静默失效。
