VSCode不运行Swift代码，依赖系统swift命令行工具链；macOS是唯一稳定支持全流程的平台；Windows官方不支持。需正确配置PATH、tasks.json和launch.json，并手动执行swift package resolve更新缓存。
VSCode 本身不运行 Swift 代码，它只负责编辑和调度；真正执行靠的是系统级 swift 命令行工具链 —— 没装好这个，点再多“运行”按钮都没用。Windows 上目前官方不支持 Swift 开发，强行配置成功率极低、调试完全不可用；macOS 是唯一能稳定跑通全流程（编辑 → 构建 → 调试）的平台。
macOS 下 swift run 为什么在 VSCode 终端里报 command not found
这不是 VSCode 的锅，是 shell 环境没把 Swift 工具链路径带进来。Xcode 自带的 Swift（比如 /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift）默认不进终端 PATH，尤其 VSCode 从 Dock 启动时更常丢掉 shell 配置。
实操建议：
- 先在终端里运行
which swift和swift --version，确认命令可用 - 如果输出正常但 VSCode 集成终端报错，说明它没读取你的
~/.zshrc或~/.bash_profile；可手动在 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
点“运行”按钮没反应，或提示 No build task defined
VSCode 不像 Xcode 那样自动识别 Swift 项目。它需要你明确告诉它“怎么构建”，否则连 swift build 都不会触发。
实操建议：
- 确保项目根目录有
Package.swift（用swift package init --type=executable创建） - 在
.vscode/tasks.json里定义构建任务，例如：{ "version": "2.0.0", "tasks": [ { "label": "build", "type": "shell", "command": "swift build", "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false } } ] } - 按
Cmd+Shift+B（macOS）调出任务选择器，选 “build” 手动触发一次；成功后.build/debug/YourTarget才存在，后续才能调试 - 别依赖 CodeRunner 插件跑单文件——
swift run必须在 SPM 项目上下文中才有效，直接swift main.swift只适用于极简脚本，且无法 debug
launch.json 配置后断点灰色、变量显示
这几乎 100% 是编译产物没带调试符号，或者调试器根本没加载对的二进制。
实操建议：
- 确认你用的是
swift build --configuration debug（默认就是 debug，但如果你在tasks.json里写了swift build --configuration release，那断点必失效） -
launch.json中"program"必须是绝对路径或工作区相对路径，指向.build/debug/YourExecutable，不是Sources/下的源码，也不是swift run YourExecutable这种命令 - macOS 上必须装 CodeLLDB 扩展（不是 VSCode 自带的 C++ 调试器），且 launch.json 的
"type"设为"lldb"；若用 Swift 官方 toolchain，可能还需指定"lldb.executable": "/path/to/sourcekit-lsp/../usr/bin/lldb" - 首次调试前，在终端手动跑一遍
swift build，看是否生成.build/debug/YourExecutable；没有就别点调试，VSCode 不会帮你补这步
Windows 用户看到这儿可以停了。Swift 官方从未发布 Windows 版 toolchain，社区移植版（如 swift-windows）仅支持基础编译，sourcekit-lsp、LLDB 调试、Package Manager 全都不可用。所谓“VSCode + Swift on Windows”目前只存在于教程标题里，实际连语法高亮都常错乱。真要跨平台，优先选 macOS 或 Linux。
最易被忽略的一点：每次改完 Package.swift 或增删依赖，sourcekit-lsp 不会自动重载——你得手动运行 swift package resolve，否则跳转失效、补全卡顿、错误提示滞留，全是因为 LSP 还在用旧的 .build 缓存。
