Swift在Linux需手动安装官方工具链并正确配置PATH与LD_LIBRARY_PATH，否则build/test失败；Ubuntu系有预编译包，CentOS/RHEL不支持；VSCode调试需同时满足sourcekit-lsp路径正确、lldb版本匹配及Package.swift存在。
swift 在 Linux 上不是系统包管理器默认提供的语言，必须手动下载官方预编译工具链并正确配置环境变量和运行时路径——否则 swift --version 能跑，但 swift build 或 swift test 会直接失败。
下载与解压 Swift 工具链要选对版本和架构
Swift 官方只提供特定 Ubuntu/Debian 版本的二进制包（如 ubuntu22.04、ubuntu24.04），不支持 CentOS/RHEL 直接用 rpm 包安装。当前（2026 年）推荐使用 swift-5.9-RELEASE 或更新的快照版（如 swift-6.0-SNAPSHOT-2026-04-15-a）。
常见错误现象：wget 下载链接 404、解压后 usr/bin/swift 无法执行（报 no such file or directory，实为缺少动态库依赖）。
- 先确认系统架构：
uname -m—— 多数云服务器是x86_64，ARM 机器需选aarch64包 - 检查 glibc 版本：
ldd --version，Ubuntu 22.04+ 通常兼容；老系统（如 18.04）可能需降级到swift-5.7 - 下载后别直接
tar -xzf到/opt：建议解压到用户目录（如~/swift-5.9），避免权限问题
PATH 和 LD_LIBRARY_PATH 缺一不可
swift 命令本身只是个前端，真正干活的 libswiftCore.so、libsourcekitd.so 等都在 usr/lib/swift/linux/ 下。Linux 动态链接器默认不查这个路径，所以只设 PATH 不够。
典型报错：error: unable to load standard library，或 VSCode 里 sourcekit-lsp 启动即退出。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 在
~/.bashrc中添加两行（路径按你实际解压位置替换）：export PATH=$HOME/swift-5.9/usr/bin:$PATHexport LD_LIBRARY_PATH=$HOME/swift-5.9/usr/lib/swift/linux:$LD_LIBRARY_PATH - 别漏掉
source ~/.bashrc；VSCode 集成终端需重启才能继承新变量 - 如果用 Snap 安装过 Swift（比如从 Ubuntu 软件中心点的），必须卸载：
sudo snap remove swift，否则沙盒会拦截LD_LIBRARY_PATH
VSCode 调试前必须做三件事
装了 vonage.vscode-swift 插件 ≠ 能调试。它只提供 UI 层，后端服务 sourcekit-lsp 和调试器 lldb 必须各自就位且路径匹配。
-
sourcekit-lsp必须在PATH中：运行which sourcekit-lsp应返回/home/xxx/swift-5.9/usr/bin/sourcekit-lsp - VSCode 设置里显式填
"swift.path.sourceKitLSP"字段，值为上面那个绝对路径——自动发现经常失效 - 调试用的
lldb版本必须和 Swift 匹配：Ubuntu 22.04+ 推荐lldb-16，装完后在launch.json里写死："lldb.executable": "/usr/bin/lldb-16"
Package.swift 修改后 sourcekit-lsp 不自动重载
改了依赖或加了新 target，VSCode 里代码提示还卡在旧状态？这不是插件 bug，是 sourcekit-lsp 的设计限制：它只读 .build/ 下的缓存元数据，不监听文件变化。
必须手动触发重建：
- 在项目根目录运行：
swift package resolve（刷新依赖图） - 再运行：
swift build（生成最新.build/debug/结构） - VSCode 右下角状态栏出现 “SourceKit-LSP: Ready” 才算生效
- 如果仍不提示，试试命令面板里执行 “Restart SourceKit-LSP Server”
最容易被忽略的是：工作区根目录下没有 Package.swift（哪怕内容为空），sourcekit-lsp 就根本不会启动——它连项目边界都识别不了。
