可在非 Mac 设备上通过三种方式配置 VSCode Swift 开发环境:一、安装 Swift 官方 Linux 工具链并搭配 VSCode Swift 插件;二、使用 Docker Dev Container 隔离运行 Swift;三、借助 WSL2 在 Windows 中部署 Swift 并集成 VSCode 远程开发。
如果您希望在非 mac 设备上使用 vscode 进行 swift 编程,但发现 swift 官方 工具 链仅原生支持 macos,这可能导致编译器不可用、语法高亮异常或调试功能缺失。以下是针对该限制的多种可行路径:
本文运行环境:Dell XPS 13,Ubuntu 24.04
一、通过 Swift 官方 Linux 工具链配合 VSCode 插件构建开发环境
Swift 官方为 Linux 提供了完整编译器与标准库支持,可直接安装二进制包,并借助 VSCode 的 Swift 插件实现基础编辑与构建能力。
1、访问 swift.org/download 页面,下载适用于 Ubuntu 24.04 的 swift-5.9-RELEASE-ubuntu22.04.tar.gz(兼容 24.04)。
2、解压至 /opt/swift 目录,并将 /opt/swift/usr/bin 添加至系统 PATH 环境变量。
3、执行 swift --version 确认命令行可用,输出应显示 5.9 版本信息。
4、在 VSCode 中安装扩展“Swift for Visual Studio Code”(由 ssen GitHub 仓库维护)。
5、打开一个空文件夹,在其中创建 Package.swift 文件并输入最小化内容:import PackageDescription; let package = Package(name: “Hello”)。
6、按 Ctrl+Shift+ P 调出命令面板,输入“Swift: Resolve Package”,触发依赖解析与工具链绑定。
二、使用 Docker 容器隔离 Swift 运行时并集成 VSCode Dev Container
通过 Dev Container 在 VSCode 中启动预配置的 Swift Linux 容器,避免宿主机环境污染,确保工具链版本精确可控。
1、在项目根目录新建 .devcontainer/devcontainer.json 文件。
2、在该文件中指定镜像为swift:5.9-jammy(官方 Docker Hub 提供的 Ubuntu 22.04 基础镜像)。
3、在 devcontainer.json 中配置 postCreateCommand 字段,执行 swift build --enable-test-discovery 以验证编译器就绪。
4、安装 Remote – Containers 扩展后,点击命令面板中的“Dev Containers: Reopen in Container”。
5、容器启动完成后,在 VSCode 内新建main.swift,输入print("Hello from Swift in Docker")。
6、按 Ctrl+Shift+ P 运行“Swift: Build Workspace”,生成可执行文件于 .build/debug/ 目录下。
三、借助 WSL2 在 Windows 上部署原生 Swift Linux 环境并映射 VSCode 工作区
利用 WSL2 的完整 Linux 内核能力运行 Swift 工具链,再通过 VSCode 的 WSL 扩展直接编辑和调试,获得接近原生 Linux 的开发体验。
1、在 Microsoft Store 中安装 Windows Subsystem for Linux,选择 Ubuntu 24.04 发行版。
2、启动 Ubuntu 终端,执行 sudo apt update && sudo apt install curl gnupg2 wget 安装依赖工具。
3、导入 Swift GPG 密钥:curl -sL https://swiftpackageindex.com/keys/swift.gpg | gpg --dearmor -o /usr/share/keyrings/swift.gpg。
4、添加 Swift APT 仓库源地址至/etc/apt/sources.list.d/swift.list,内容为:deb [arch=amd64 signed-by=/usr/share/keyrings/swift.gpg] https://archive.ubuntu.com/ubuntu jammy main。
5、运行 sudo apt update && sudo apt install swift-lang 完成安装。
6、在 Windows 端安装 VSCode,启用“Remote – WSL”扩展,然后从 WSL 终端中执行 code . 打开当前目录。