需依次完成四步：一、安装 Swift 工具链并配置 PATH；二、在 VS Code 中选择工具链启用 SourceKit-LSP；三、配置 .vscode/settings.json 指定 swift.path、sourceKitLSP 和 sdk；四、用 SPM 初始化项目并以文件夹形式打开。
如果您在 Visual Studio Code 中配置 Swift 开发环境时遇到语法高亮缺失、代码补全失效或调试无法启动等问题，则可能是由于 Swift 工具链未正确集成或扩展配置不匹配。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Swift 工具链并验证路径
Swift for VS Code 依赖本地 Swift 编译器和语言服务器（SourceKit-LSP），必须确保系统级 Swift 工具链已安装且可被 VS Code 访问。
1、访问 swift.org/download 下载适用于 macOS 的最新 Swift 工具链 DMG 安装包。
2、双击安装包完成安装，默认路径为 /Library/Developer/Toolchains/swift-latest.xctoolchain。
3、在终端中执行 swift --version 确认命令行可调用；若提示未找到，需将工具链 bin 目录加入 PATH，例如：export PATH="/Library/Developer/Toolchains/swift-latest.xctoolchain/usr/bin:$PATH"。
二、启用 SourceKit-LSP 作为语言服务器
VS Code 的 Swift 扩展不再使用旧版 SourceKit，必须通过 SourceKit-LSP 提供语义分析与智能提示功能，该服务需独立启用并关联至 Swift 工具链。
1、在 VS Code 中打开命令面板（Cmd+Shift+P），输入并选择 Swift: Select Toolchain。
2、从列表中选择已安装的 swift-latest.xctoolchain 条目。
3、重启 VS Code 后，打开任意 .swift 文件，观察右下角状态栏是否显示 SourceKit-LSP Active。
三、配置 Swift 扩展的 workspace 设置
项目级行为受 .vscode/settings.json 控制，需显式指定构建路径、SDK 类型及 LSP 启动参数，避免默认配置导致索引失败。
1、在项目根目录创建 .vscode/settings.json 文件（若不存在）。
2、写入以下内容：
{"swift.path": "/Library/Developer/Toolchains/swift-latest.xctoolchain/usr/bin/swift","swift.sourceKitLSP.enabled": true,"swift.sdk": "macosx"}
3、保存后，按下 Cmd+Shift+P 并执行 Swift: Restart Language Server。
四、使用 Swift Package Manager 初始化项目结构
VS Code 的 Swift 扩展对 SPM 项目支持最完整，非 SPM 结构（如纯文件夹或 Xcode 项目）可能导致符号解析中断，需强制转换为标准包格式。
1、在终端进入空项目目录，执行 swift package init --type executable。
2、VS Code 中通过 File → Open Folder 重新打开该目录，而非单个 .swift 文件。
3、等待右下角出现 Resolving package dependencies... 完成后，自动加载依赖图谱与模块符号。
