vscode需手动配置sourcekit-lsp路径、设置ld_library_path环境变量、运行swift package resolve刷新依赖，且调试须用.build/debug/下的二进制并安装匹配lldb。
Swift插件装了但代码不提示、不报错
VSCode本身不原生支持Swift，必须靠Swift Language Server（即sourcekit-lsp）驱动语法分析。只装vonage.vscode-swift这类插件没用，它只是前端，后端服务没起来，编辑器就“看不见”Swift语义。
- 确认已安装Swift工具链：
swift --version能输出版本（推荐5.9+），且sourcekit-lsp在PATH中（通常随Swift一起安装，路径类似/usr/bin/sourcekit-lsp或/opt/swift/usr/bin/sourcekit-lsp） - VSCode设置里必须显式指定
"swift.path.sourceKitLSP"，不能依赖自动发现——Linux下常因PATH环境差异导致找不到，建议写死绝对路径 - 工作区根目录下要有
Package.swift（哪怕空的），否则sourcekit-lsp启动后立即退出，提示消失、断点失效都源于此
调试时断点不命中、显示“no debug adapter”
VSCode的lldb调试器无法直接调试Swift可执行文件，必须通过swift run或swift build生成带调试信息的二进制，并让调试器正确加载符号。
- 确保用
swift build --configuration debug构建（默认就是debug，但CI或自定义脚本可能覆盖）；release模式下断点必然失效 -
launch.json中"program"字段必须指向.build/debug/xxx下的可执行文件，不能是源码路径或swift run xxx命令 - Linux上需额外安装
lldb-16（或匹配Swift版本的LLDB），Ubuntu/Debian系运行sudo apt install lldb-16，并设"lldb.executable": "/usr/bin/lldb-16"
Linux下swift test运行失败，报error: unable to load standard library
这是典型的Swift运行时路径未识别问题。Linux发行版无系统级Swift安装机制，swift命令能跑，不代表动态链接器能找到libswiftCore.so等库。
- 运行
swift build前先执行export LD_LIBRARY_PATH="/path/to/swift/usr/lib/swift/linux:$LD_LIBRARY_PATH"（路径以swift --version输出的安装位置为准） - 更稳妥的做法：把该
export加入~/.bashrc或~/.profile，否则VSCode终端可能不继承该变量，导致集成终端里swift test失败 - 若用Snap安装的Swift（如Ubuntu软件中心），会因沙盒限制无法访问系统库，必须改用官方tar.gz包解压安装
修改Package.swift后代码提示延迟或错乱
sourcekit-lsp不会自动重载项目配置，它依赖swift package resolve生成的.build元数据。手动改完Package.swift，不触发解析，LSP就继续用旧缓存。
- 保存
Package.swift后，在VSCode集成终端运行swift package resolve（不是swift build） - 或点击VSCode右下角Swift状态栏里的
Resolve Package按钮（有闪电图标） - 频繁修改依赖时，可配一个文件监视任务：
"problemMatcher": "$swift"配合watchexec -w Package.swift -- swift package resolve，但注意别和VSCode自带的文件监听冲突
Swift在Linux上的环境不是“装完插件就能写”，关键路径、环境变量、构建阶段三者必须对齐。最容易被忽略的是：VSCode窗口启动时没读取~/.profile里的LD_LIBRARY_PATH，导致调试器找得到lldb却加载不了Swift运行时——关掉所有VSCode再重新从终端启动一次，往往就通了。
