需手动配置语言支持、工具链集成与调试环境；先安装 Swift 工具链并配置 PATH，再安装 VSCode 扩展并设置 swift.path 和 serverPath，接着用 swift package init 创建项目，最后配置 launch.json 启用 LLDB 调试。
如果您希望在 Linux 或 Windows 系统上使用 VSCode 进行 Swift 开发，则需手动配置语言支持、工具 链集成与调试环境，因为 Swift 官方未提供原生的跨平台 IDE 支持。以下是实现该目标的具体操作路径：
本文运行环境：ThinkPad X1 Carbon，Ubuntu 24.04。
一、安装 Swift 工具链
VSCode 本身不包含 Swift 编译器，必须先在系统中部署官方 Swift 工具链，以确保编译、语法检查和代码补全功能正常运作。
1、访问 swift.org/download 页面，下载适用于当前系统的 Swift 5.9 或更高版本的 Linux toolchain 包（.tar.gz）。
2、解压 归档至 /opt/swift 目录，并执行 sudo chown -R $USER:$USER /opt/swift 调整权限。
3、将 /opt/swift/usr/bin 添加至系统 PATH：在 ~/.bashrc 或 ~/.zshrc 中追加 export PATH=”/opt/swift/usr/bin:$PATH”，随后运行 source ~/.bashrc 生效。
二、配置 VSCode 扩展与设置
VSCode 需借助第三方扩展识别 Swift 语法、调用 LSP 服务并提供智能提示，核心依赖 Swift for Visual Studio Code 扩展及其底层服务器实现。
1、在 VSCode 扩展市场中搜索并安装 Swift for Visual Studio Code（作者：Chunqi Li）。
2、打开 VSCode 设置（Ctrl+,），搜索 swift.path，将其值设为 /opt/swift/usr/bin/swift。
3、在用户设置 JSON 中添加键值对：“swift.serverPath”: “/opt/swift/usr/bin/sourcekit-lsp”，确保语言服务器可被正确调用。
三、初始化 Swift 项目结构
VSCode 不具备新建 Swift 项目的向导功能，必须通过命令行生成符合 SwiftPM 规范的目录结构，以便扩展识别模块依赖与入口点。
1、在终端中执行 mkdir myapp && cd myapp 创建项目根目录。
2、运行 swift package init –type executable 初始化可执行项目模板。
3、在 VSCode 中使用 File → Open Folder 打开该目录，等待扩展自动检测 Package.swift 并加载符号索引。
四、启用断点调试支持
Linux/Windows 上的 Swift 调试需依赖 LLDB 后端 与适配的调试器插件，VSCode 默认调试配置无法直接识别 Swift 可执行文件，须手动编写 launch.json。
1、在项目根目录下创建 .vscode 文件夹，进入后执行 code .vscode/launch.json。
2、填入以下内容：{“version”:”0.2.0″,”configurations”:[{“name”:”Debug Swift”,”type”:”cppdbg”,”request”:”launch”,”program”:”${workspaceFolder}/.build/x86_64-unknown-linux-gnu/debug/myapp”,”args”:[],”stopAtEntry”:false,”cwd”:”${workspaceFolder}”,”environment”:[],”externalConsole”:false,”MIMode”:”lldb”,”miDebuggerPath”:”/usr/bin/lldb”}]}。
3、确认 .build/x86_64-unknown-linux-gnu/debug/myapp 路径与实际构建输出一致，必要时先运行 swift build 生成二进制。
