sourcekit-lsp未运行导致vscode仅支持语法高亮；必须确保系统级swift工具链（≥5.9）已安装并可执行swift --version和sourcekit-lsp --help，手动在vscode中配置swift.path.sourcekitlsp为绝对路径，且用open folder打开含package.swift的swiftpm项目根目录。
sourcekit-lsp 没跑起来，VSCode 就只是个带语法高亮的文本编辑器——装插件、开文件、写代码全对，但跳转、补全、诊断全失效。必须手动配对工具链、路径和项目结构，缺一不可。
确认系统级 Swift 工具链已就位
VSCode 不自带编译器，所有 swift build、swift test、sourcekit-lsp 都依赖你本地装好的工具链。别信“Xcode 自带就够了”这种说法，Xcode 自带的 Swift 有沙盒限制，常导致 sourcekit-lsp 启动失败或无法解析第三方包。
- 推荐用 Homebrew 安装独立工具链：
brew tap swift-lang/swift && brew install swift（截至 2026 年 6 月，最新稳定版为 5.9+） - 终端运行
swift --version和sourcekit-lsp --help，两者都得有输出；若后者报command not found，说明工具链没包含 LSP 或 PATH 没生效 - Homebrew 安装后，
sourcekit-lsp通常在/opt/homebrew/bin/sourcekit-lsp（M1/M2）或/usr/local/bin/sourcekit-lsp（Intel），不是/usr/bin/ - 别用
xcode-select -s /Applications/Xcode.app强切路径来“凑合”，它会覆盖掉你刚装的独立工具链，导致版本错乱
装对插件并填死 swift.path.sourceKitLSP
目前最稳的是 sschmid.Swift（发布者 Stefan Schmid），它专为 sourcekit-lsp 设计。装完不能直接用，必须手动指定 LSP 路径——VSCode 不会自动探测，尤其在非标准安装路径下几乎必挂。
PyCharm 2026.2.0.1 Mac版
下载
PyCharm 2026.2.0.1 Mac版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合在macOS系统上进行 Python 项目开发、运行、调试和测试。
- 打开 VSCode 设置（
Cmd+,），搜swift.path.sourceKitLSP，填入终端里which sourcekit-lsp输出的**完整绝对路径**，例如：/opt/homebrew/bin/sourcekit-lsp - 路径里不能含
~、空格或中文；填错或留空，插件启动时静默失败，右下角状态栏不会显示SourceKit-LSP Active - 顺手关掉设置项
Editor: Suggest: Snippets Prevent Quick Suggestions，否则补全卡顿甚至假死 - 重启 VSCode 或执行
Developer: Reload Window，否则新路径不加载
必须用 Open Folder 打开 SwiftPM 项目根目录
直接双击打开 main.swift 是最常见的失败源头。sourcekit-lsp 需要完整的构建上下文才能解析 import、定位 SDK 和依赖，单文件无 Package.swift 就等于没 workspace。
- 终端进空目录，运行：
swift package init --type=executable（生成Package.swift、Sources/、Tests/） - VSCode 中选
File > Open Folder，打开该目录（不是打开Sources/App/main.swift） - 首次打开后，右下角会显示
Building workspace，这是swift build --generate-diagnostics在后台运行；等它完成（通常几秒到半分钟），跳转和补全才真正可用 -
.xcodeproj、.swiftpm或.swift-version单独存在都不行，插件只认Package.swift+ 标准目录结构
格式化和调试需额外闭环
格式化和调试是两个独立通道，不依赖 sourcekit-lsp，但也极易因路径或配置断裂而静默失效。
- 格式化靠
swiftformat：用brew install swiftformat，然后在 VSCode 设置中搜swiftformat path，填which swiftformat的完整路径（如/opt/homebrew/bin/swiftformat）；启用editor.formatOnSave，再加一个项目级.swiftformat配置文件 - macOS 调试必须配
launch.json：VSCode 不自动生成，需手动在.vscode/launch.json里写清楚program指向.build/debug/YourTargetName，且构建模式必须是debug（swift build -c debug） - 断点灰色、变量显示
<error type></error>，90% 是因为launch.json里program路径错，或没先运行swift build生成可执行文件
sourcekit-lsp 的路径、Package.swift 的存在、launch.json 的 program 字段——这三个地方出错，都不会弹红框报错，只会让你以为“功能坏了”。它们安静地失效，比报错更难排查。
