VSCode真正支持Swift开发的核心是sourcekit-lsp进程稳定运行；需先验证sourcekit-lsp --help可执行，再手动配置swift.path.sourceKitLSP为绝对路径，项目必须以含Package.swift的文件夹形式打开，并关闭Snippets Prevent Quick Suggestions。
VSCode 要真正支持 Swift 开发（跳转、补全、诊断、重构），核心不是装插件，而是让 sourcekit-lsp 进程稳定跑起来——插件只是个转发层，它连不上，就只剩语法高亮。
确认 sourcekit-lsp 可执行且路径正确
这是整个配置的基石。VSCode 的 Swift 插件（如 sschmid.Swift）不自带 sourcekit-lsp，它只调用你系统里那个二进制。如果终端里 sourcekit-lsp --help 报 command not found，VSCode 配置再对也白搭。
- macOS 上，若用 Xcode 工具链：先运行
sudo xcode-select -s /Applications/Xcode.app，再查/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/sourcekit-lsp - macOS 上，若用 Homebrew 安装的 Swift：
brew install swift后路径通常是/opt/homebrew/bin/sourcekit-lsp - Linux/WSL2：解压官方 Swift 包后，常见路径是
/opt/swift/usr/bin/sourcekit-lsp；记得把它加进~/.bashrc的PATH并source ~/.bashrc - Windows 原生不支持
sourcekit-lsp，必须走 WSL2，且 VSCode 必须通过Remote - WSL扩展打开项目，否则PATH不继承
手动填入 swift.path.sourceKitLSP 绝对路径
VSCode 几乎从不自动发现 sourcekit-lsp，尤其在多工具链或 WSL2 环境下。留空、填相对路径、用 ~ 代换，都会导致连接失败。
- 打开设置（
Cmd+,或Ctrl+,），搜索swift.path.sourceKitLSP - 填入完整绝对路径，例如：
/opt/swift/usr/bin/sourcekit-lsp（Linux/WSL2）或/Library/Developer/Toolchains/swift-5.9-RELEASE.xctoolchain/usr/bin/sourcekit-lsp（macOS 独立 toolchain） - 路径中不能含空格或中文；务必和终端里
swift --version输出的版本对应——Xcode 和独立 toolchain 的sourcekit-lsp不能混用 - 填完后重启 VSCode 或执行
Developer: Reload Window
必须用 Open Folder 打开 SwiftPM 根目录
双击打开单个 .swift 文件，sourcekit-lsp 启动后会静默退出，并报 no workspace 或 unable to resolve package。它需要 Package.swift 来识别项目结构和依赖。
- 终端进空目录，运行
swift package init --type=executable（或--type=library）生成标准结构：Package.swift、Sources/、Tests/ - 在 VSCode 中选择
File > Open Folder，打开这个根目录（不是Sources/，也不是某个.swift文件） - 首次打开后，右下角状态栏会显示
Building workspace，这是swift build --generate-diagnostics在后台运行；等它完成，符号索引才真正可用 - 别指望
.xcodeproj或.swiftpm能被识别——插件只认 SwiftPM 元数据
顺手关掉 Snippets Prevent Quick Suggestions
这个设置项默认开启时，会导致代码补全响应极慢、卡顿甚至完全无反应，现象是输入几个字母后补全框迟迟不弹出或直接消失。
- 打开设置，搜索
Snippets Prevent Quick Suggestions - 把
Editor: Suggest: Snippets Prevent Quick Suggestions设为false - 无需重启，改完即生效
最常被忽略的是：sourcekit-lsp 的路径和你当前终端所用的 Swift 工具链必须严格一致——哪怕只差一个小版本，也可能导致跳转失效或诊断信息错乱。检查方式很简单：在 VSCode 内置终端里运行 swift --version 和 sourcekit-lsp --help，两个命令都得成功，且输出的版本号能对上。
