Windows无法原生运行Swift，因官方从未发布Windows原生工具链，所谓“安装包”多为过时移植或包装脚本，缺乏swiftc、sourcekit-lsp及运行时支持，导致语言服务不可用、构建失败、调试器不兼容。
Windows 上无法原生运行 Swift 代码，必须走 WSL2；macOS 是唯一能稳定支持编辑、构建、调试全流程的平台。
Windows 下为什么不能直接装 Swift 工具链
Swift 官方从不发布 Windows 原生工具链，所有声称“Windows 版 Swift”的安装包要么是过时社区移植、要么只是包装脚本。你在 PowerShell 里执行 swift --version 成功，大概率只是符号链接或 shell 包装器——背后没有真正的 swiftc、sourcekit-lsp 或运行时支持。
关键后果：
• sourcekit-lsp 根本无法启动，VSCode 插件连语言服务器都连不上
• swift run 报错或静默失败，因为缺少 Linux 环境下的标准库路径和动态链接行为
• 调试器（LLDB）完全不可用，Windows NT 内核不兼容 Swift 的 DWARF 符号解析逻辑
• 所有依赖 SPM 构建的项目（包括 Package.swift 解析）都会卡在 swift package resolve 阶段
WSL2 + Ubuntu 是 Windows 唯一可行路径
实操步骤必须严格按顺序执行，跳步会导致 sourcekit-lsp 启动失败或 VSCode 插件静默不响应：
• 以管理员身份运行 PowerShell，执行 wsl --install，重启后安装 Ubuntu 24.04（不要选其他发行版）
• 在 WSL2 终端中下载官方包：wget https://download.swift.org/swift-5.9-release/ubuntu2404/swift-5.9-RELEASE/swift-5.9-RELEASE-ubuntu24.04.tar.gz
• 解压到 /opt/swift，并确保权限可执行：sudo chown -R $USER:$USER /opt/swift
• 追加环境变量到 ~/.bashrc：export PATH="/opt/swift/usr/bin:$PATH"，然后 source ~/.bashrc
• 验证两件事：swift --version 和 sourcekit-lsp --help 都必须输出内容，缺一不可
• VSCode 必须通过 Remote - WSL: New Window 启动，并用 File > Open Folder 打开 WSL2 内路径（如 /home/yourname/myproject），不能打开 C:\... 路径
macOS 上 swift run 报 command not found 怎么办
这不是插件问题，是 VSCode 启动时没加载 shell 的 PATH。Xcode 自带的 Swift 路径（如 /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift）默认不在终端全局 PATH 中，尤其从 Dock 启动 VSCode 时更常见。
解决方式优先级排序：
• 先在 macOS 终端确认：which swift 是否返回路径，swift --version 是否正常
• 若终端正常但 VSCode 集成终端报错，在 VSCode 设置中手动补全："terminal.integrated.env.osx": { "PATH": "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin:${env:PATH}" }
• 更可靠的方式：用 swiftenv 管理版本，或从 swift.org 下载独立 toolchain 安装到 /Library/Developer/Toolchains/，再软链进 /usr/local/bin
• 别依赖 brew install swift —— Homebrew 的 Swift tap 已停更，且与 Xcode 工具链冲突风险高
VSCode 没有“一键运行”按钮，必须靠 tasks.json 或终端
VSCode 不像 Xcode 那样自动识别 Swift 项目上下文。点“运行”没反应，本质是没定义构建任务，swift run 无处触发。
必须做三件事：
• 项目根目录要有 Package.swift（用 swift package init --type executable 创建）
• 在 .vscode/tasks.json 里明确定义构建任务，例如：
{
"version": "2.0.0",
"tasks": [
{
"label": "build & run",
"type": "shell",
"command": "swift run",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false
}
}
]
}• 首次运行前，先手动执行一次
swift build，确保生成 .build/debug/ 目录——否则 swift run 会报 “no executable product”• 别用 CodeRunner 插件跑单文件：它调的是
swift main.swift，绕过 SPM，无法 debug，也无法解析 import 第三方包
最容易被忽略的点：WSL2 下 VSCode 的 Swift 插件（如 sschmid.Swift）必须在设置里显式填入 swift.path.sourceKitLSP，值为 /opt/swift/usr/bin/sourcekit-lsp；macOS 下如果用了 Xcode 工具链，还要先执行 sudo xcode-select -s /Applications/Xcode.app，否则 sourcekit-lsp 启动即退出。
