Linux下怎么安装Swift编程语言

Swift 在 Linux 上的安装，说实话，跟一键 apt install swift 基本无缘。必须先手动下载官方工具链，然后老老实实配好两个关键的环境变量——尤其是 LD_LIBRARY_PATH，否则就算 swift --version 能正常输出版本号，真正跑项目时 swift build 也必然会栽跟头。这不是玄学，而是 Swift 运行时依赖动态库的底层机制决定的。

我先直接说结论：哪怕你在终端敲 swift --version 感觉一切正常，只要 LD_LIBRARY_PATH 没配对，swift build 必定失败。这个坑，很多人第一次踩的时候都觉得莫名其妙，但其实是完全可预期的。

下载前，先确认系统兼容性

Swift 官方只面向 Ubuntu/Debian 系提供预编译包，CentOS 或 RHEL 用户就别想着直接下载安装了。目前（2026 年中），推荐的两个版本是稳定的 swift-5.9-RELEASE 或者尝鲜的 swift-6.0-SNAPSHOT-2026-04-15-a。

但别急着下载，有几个细节需要注意：

• 先用 uname -m 确认你的 CPU 架构。x86_64 的机器选择 ubuntu22.04 或 ubuntu24.04 的包；如果用的是 ARM 架构的服务器或树莓派，必须选名字里带 aarch64 的版本。
• 运行 ldd --version 查看 glibc 版本。Ubuntu 22.04 及更新的系统基本都能直接跑；但如果你还在用 Ubuntu 18.04 或更老的系统，建议降级到 swift-5.7，否则解压后执行 swift 时，可能会报一个让人摸不着头脑的 “No such file or directory”——其实不是文件不存在，而是动态库链接失败。
• 另外，别随手复制粘贴网上那些旧教程里的 wget 链接，很多早已 404。正确的做法是去 Swift 官网的 Linux 栏目下，找到对应系统和版本的最新 Release 或 Snapshot 链接，手动复制。

解压后，两条环境变量缺一不可

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:$PATH
export 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。因为 Snap 的沙盒机制会屏蔽你手动设置的 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 的版本必须与 Swift 工具链匹配。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”，完全不会告诉你具体是哪个环节出了问题。

正是这些看似平常的细节，往往决定了 Swift 在 Linux 上能否真正跑起来。谨慎一点，总归没错。