vscode需配合系统swift工具链、sschmid.swift插件及spm项目结构才能支持swift开发；须安装≥5.9版本工具链，配置sourcekit-lsp路径，用swift package init初始化项目，并为macos调试手动配置launch.json。
VSCode 本身不支持 Swift 编译与调试，必须依赖外部工具链和插件协同工作；直接装个插件就写 Swift 是行不通的。
确认系统已安装 Swift 工具链（macOS / Linux）
VSCode 只是编辑器，swiftc、swift build、swift test 这些命令全靠系统级 Swift 工具链提供。没装好这个，后面所有配置都白搭。
- macOS 用户优先用
brew install swift（推荐官方 Swift.org 的swift-langtap，而非 Xcode 自带的受限版本） - Linux 用户必须从 swift.org/download 下载对应发行版的预编译包，解压后把
usr/bin加入$PATH - 运行
swift --version和swift build --version都应有输出，且版本 ≥ 5.9（低于此版本可能缺少swift package init --type=executable等关键能力）
安装 Swift 插件并禁用默认 LSP 冲突
目前最稳定的是 sschmid.Swift（作者 Stefan Schmid），它基于 SourceKit-LSP，但 VSCode 自带的 LSP 客户端行为有时会干扰连接。
- 在扩展市场搜
Swift，认准发布者为sschmid，安装后重启 VSCode - 打开设置（
Cmd+,/Ctrl+,），搜索swift.sourcelkit-lsp.path，设为你的sourcekit-lsp实际路径（通常随 Swift 工具链安装在/usr/bin/sourcekit-lsp或~/swift/usr/bin/sourcekit-lsp） - 务必关闭 VSCode 内置的
Editor: Suggest: Snippets Prevent Quick Suggestions，否则代码补全常卡住 - 如果打开
.swift文件后无语法高亮或跳转失效，检查终端能否手动运行sourcekit-lsp --help—— 失败说明路径错或权限不足
用 Swift Package Manager 初始化项目结构
VSCode 不识别 Xcode 的 .xcodeproj，必须用 SPM 创建标准目录，否则插件无法解析依赖和符号。
- 终端进入空文件夹，运行
swift package init --type=executable（或--type=library） - 确保生成了
Package.swift、Sources/、Tests/等标准结构 - 在 VSCode 中用
File > Open Folder...打开该根目录（不是打开单个.swift文件） - 首次打开时插件会自动触发
swift package resolve，若卡住可手动运行该命令再重试 - 注意：SPM 默认不生成 Xcode 工程，别指望右键“Open in Xcode”能用 —— 这不是 bug，是设计如此
调试需额外配置 launch.json（仅限 macOS）
Linux 上 lldb 调试支持尚不稳定，macOS 下可用 lldb + sourcekit-lsp 联合调试，但必须手工配 launch.json。
- 按
Cmd+Shift+D打开调试面板 → 点“create a launch.json file” → 选Swift环境 - 确认
program字段指向可执行产物路径，通常是${workspaceFolder}/.build/debug/your_package_name - 若断点不命中，检查是否在
swift build时加了-c debug（默认已有），以及Package.swift中target是否启用了debugSettings - 警告：VSCode 的 Swift 调试器不支持
print以外的控制台交互输入，需要readLine()的程序建议改用终端运行
真正麻烦的从来不是装插件，而是 Swift 工具链路径、SPM 项目结构、LSP 启动时机这三者的对齐 —— 任意一个错位，就会表现为“代码没补全”“跳转失败”“调试器连不上”。多看 Output 面板里 SourceKit-LSP 和 Swift 两个通道的日志，比反复重装插件有用得多。
