swift在linux上必须手动下载官方工具链并同时配置path和ld_library_path，否则swift build会失败；官方仅支持ubuntu/debian预编译包，推荐swift-5.9-release或swift-6.0-snapshot-2026-04-15-a，需匹配系统架构与glibc版本。
Swift 在 Linux 上不能用 apt install swift 一键装好，必须手动下载官方工具链、设对两个环境变量，否则 swift build 必然失败——哪怕 swift --version 看起来正常。
下载前先确认系统兼容性
Swift 官方只提供 Ubuntu/Debian 预编译包，不支持 CentOS/RHEL 直接安装；当前（2026 年中）推荐用 swift-5.9-RELEASE 或 swift-6.0-SNAPSHOT-2026-04-15-a。
- 运行
uname -m确认架构：x86_64 选ubuntu22.04或ubuntu24.04包；ARM 机器必须选aarch64版本 - 运行
ldd --version查 glibc 版本：Ubuntu 22.04+ 可直接用；18.04 及更老系统建议降级到swift-5.7，否则解压后swift执行会报No such file or directory（实为动态库链接失败） - 别用
wget直接粘贴旧教程链接——很多已 404；正确做法是去 https://www.php.cn/link/b02c1aa1ed3db1bf3ff447e6292aaa3a 找 Linux 栏目下对应系统的最新 Release 或 Snapshot 链接
解压后必须同时设置 PATH 和 LD_LIBRARY_PATH
swift 命令本身只是个壳，真正依赖的 libswiftCore.so、libsourcekitd.so 全在 usr/lib/swift/linux/ 下。Linux 动态链接器默认不查这个路径，只设 PATH 就像只装了遥控器却没接电源。
- 解压到用户目录，例如：
tar xzf swift-5.9-RELEASE-ubuntu22.04.tar.gz -C ~/→ 得到~/swift-5.9-RELEASE-ubuntu22.04/ - 在
~/.bashrc末尾加两行（路径按你实际位置改）：export PATH=$HOME/swift-5.9-RELEASE-ubuntu22.04/usr/bin:$PATHexport LD_LIBRARY_PATH=$HOME/swift-5.9-RELEASE-ubuntu22.04/usr/lib/swift/linux:$LD_LIBRARY_PATH - 执行
source ~/.bashrc；如果用 VSCode，需完全重启窗口——它的集成终端不会自动继承新变量 - 如果之前用 Snap 装过 Swift（比如从 Ubuntu 软件中心点的），务必先运行
sudo snap remove swift，否则沙盒会屏蔽LD_LIBRARY_PATH
VSCode 调试前要验证三件事
装了 vonage.vscode-swift 插件 ≠ 能调试。它只画界面，背后 sourcekit-lsp 和 lldb 必须各自就位且版本匹配。
- 运行
which sourcekit-lsp，输出必须是你的 Swift 工具链路径，例如/home/xxx/swift-5.9-RELEASE-ubuntu22.04/usr/bin/sourcekit-lsp - VSCode 设置里显式填
swift.path.sourceKitLSP字段，值就是上面那个绝对路径——自动发现经常失效 -
lldb版本必须匹配：Ubuntu 22.04+ 推荐装lldb-16（sudo apt install lldb-16），然后在.vscode/launch.json里写死："lldb.executable": "/usr/bin/lldb-16"
最容易被忽略的是 LD_LIBRARY_PATH 没生效，或者 VSCode 没重启导致 sourcekit-lsp 启动即退出——这时候看日志只会看到空行或 “connection closed”，而不是具体错误。
