首先安装 swift 工具链并验证版本,接着安装 sourcekit-lsp 语言服务器,然后在 vscode 中安装 Swift 插件并配置 sourcekit-lsp 路径,最后通过 Swift Package Manager 创建项目并配置调试支持,即可实现完整开发功能。

要在 VSCode 中配置 Swift 开发环境,关键在于正确安装 Swift 工具链、设置语言服务器(LSP)以及配置编辑器支持代码补全、语法高亮和调试功能。以下步骤适用于 macOS 和 linux 系统,windows 目前不原生支持 Swift。
安装 Swift 工具链
Swift 必须先在系统中可用,才能在 VSCode 中使用。
• macOS:前往 Swift 官网下载页面,下载并安装适用于 macos 的 Swift 工具链(.pkg 文件),安装后将自动配置到系统路径。
• ubuntu:从 Swift 官网下载对应版本的压缩包,解压后建议将路径添加到环境变量:
示例命令:
wget https://download.swift.org/swift-5.9-release/ubuntu2004/swift-5.9-RELEASE/swift-5.9-RELEASE-ubuntu20.04.tar.gz tar -xzf swift-5.9-RELEASE-ubuntu20.04.tar.gz sudo mv swift-5.9-RELEASE-ubuntu20.04 /usr/share/swift echo 'export PATH=/usr/share/swift/usr/bin:$PATH' >> ~/.zshrc source ~/.zshrc
验证安装:终端运行 swift –version,确认输出版本信息。
安装 Swift Language Server
VSCode 需要语言服务器提供智能提示、跳转定义等功能。推荐使用 sourcekit-lsp。
• macOS:xcode 命令行工具已包含 sourcekit-lsp,确保已安装 Xcode 命令行工具:
xcode-select --install
• Linux:需手动构建或使用预编译版本。可参考 SwiftPM 项目中的 sourcekit-lsp 编译指南,或使用社区提供的二进制文件。
构建完成后,记录 sourcekit-lsp 可执行文件路径(如 /path/to/sourcekit-lsp),后续配置需要。
配置 VSCode 插件
打开 VSCode,安装以下扩展:
- Swift for VSCode(由 Swift Server 提供):基础语法高亮与项目支持。
- CodeLLDB:用于调试 Swift 程序(Linux/macOS)。
- Language Support for Swift (sourcekit-lsp):启用 LSP 功能。
安装后,在 VSCode 设置中指定 sourcekit-lsp 路径。可通过 settings.json 手动配置:
"swift.sourcekit-search-paths": [ "/usr/lib/swift", "/usr/lib/llvm-15/lib" ], "swift.sourcekit-executable": "/path/to/sourcekit-lsp"
保存后重启 VSCode,打开一个 Swift 文件(.swift),应能看到代码补全和悬停提示。
创建并运行 Swift 项目
使用 Swift Package Manager 创建项目:
mkdir MySwiftapp cd MySwiftApp swift package init --type executable
用 VSCode 打开该目录,编辑 Sources/MySwiftApp/main.swift。可添加断点并使用 CodeLLDB 进行调试。
运行程序可在终端执行:
swift run
若想在 VSCode 内集成终端运行,可配置 tasks.json 和 launch.json 实现一键构建与调试。
基本上就这些。只要 Swift 和 sourcekit-lsp 正确安装,VSCode 就能提供良好的开发体验。


