• 桌面应用
• 跨平台
• 移动开发

导读

本篇技术指南围绕 Tauri 官方仓库（tauri-apps/tauri）自带的开发容器配置展开，讲解如何利用 VS Code Remote-Containers 在 Docker 容器中获得一套开箱即用的 Tauri 源码开发环境，包括容器镜像来源、前置条件、启动步骤、文件系统性能优化，以及如何在容器中运行并显示 Tauri GUI 窗口。读完本文，你将掌握从零搭建 Tauri 源码级开发环境（Rust + Node 双工具链、Linux WebKit/GTK 依赖齐备）的完整流程，并理解 Dockerfile 与 devcontainer.json 中每个关键配置项的实际作用。

容器总览：一个面向 Tauri 源码开发的 Ubuntu 容器

仓库根目录下的.devcontainer/目录包含三个文件：

• Dockerfile —— 容器镜像构建定义；
• devcontainer.json —— VS Code 开发容器配置清单；
• README.md —— 本指南对应的官方说明文档。

容器镜像直接派生自Microsoft 的默认 Ubuntu 开发容器（mcr.microsoft.com/vscode/devcontainers/base:0-${VARIANT}），其基础镜像内容源自 VS Code devcontainers 仓库的 Ubuntu base Dockerfile。因此，容器内部已预装 VS Code Server、常用 shell 工具以及面向开发者的基础软件包；在此基础上，Tauri 仓库通过 Dockerfile 追加安装了构建 Tauri 桌面应用所需的系统级依赖。

前置条件（Prerequisites）

在开始之前，需要准备以下三项环境：

1. Docker：推荐使用 Docker Desktop（Windows / macOS / Linux 均可）；
2. VS Code：安装了 Remote Development 扩展包（包含 Remote - Containers、Remote - SSH、WSL 等扩展）。打开本仓库时，如果安装了推荐的工作区扩展，该扩展包会自动被包含；
3. X Window 主机：如果你希望在 Docker 主机上交互式使用容器中运行的 GUI 程序（即 Tauri 窗口），Docker 主机必须运行一个 X Window server。

这些前置条件主要来源于 VS Code 官方文档中"Developing inside a Container: Getting Started"一节，遇到问题时应优先查阅 VS Code 官方容器文档。

启动开发容器的完整步骤

官方 README 给出了五步操作流程：

1. 确认已满足上述 前置条件；
2. 在 VS Code 中打开包含 Tauri 源码的目录（即本仓库根目录）；
3. 安装 Remote Development 扩展包（若已按推荐扩展安装则可跳过）；
4. 确保 Docker 正在运行；
5. 从命令面板（F1）执行Remote-Containers: Reopen in Container...，将当前工作区重新打开到开发容器中。

执行第 5 步后，VS Code 会依据.devcontainer/devcontainer.json中的构建配置读取同目录下的 Dockerfile，拉取基础镜像、安装依赖并启动容器，最终在 VS Code 中呈现一个完整的远程开发会话。

了解 devcontainer.json 的关键配置

以下是仓库自带 devcontainer.json 中值得关注的配置项及其作用：

其中features两项至关重要：Tauri 源码仓库同时包含 Rust 侧（crates/下的 14 个核心 crate，见 Cargo.toml）与 Node 侧（packages/api、packages/cli等，由 package.json 中的 pnpm workspace 管理），容器内预置 Node.js 与 Rust 工具链后，进入容器即可直接执行cargo build与pnpm install，无需手工安装语言运行时。

Dockerfile 中的 Tauri 构建依赖解析

Dockerfile 的核心逻辑只有一段apt-get install，但其依赖清单完整覆盖了 Tauri v2 在 Linux 上编译桌面应用所需的全部系统库：

ARG TAURI_BUILD_DEPS="build-essential curl libappindicator3-dev libgtk-3-dev librsvg2-dev libssl-dev libwebkit2gtk-4.1-dev wget"

逐项说明各依赖的实际用途：

• build-essential：提供 gcc/g++、make 等编译工具链，Rust 链接原生库必需；
• libgtk-3-dev：GTK 3 开发头文件，Tauri 在 Linux 上创建窗口与 UI 的基础；
• libwebkit2gtk-4.1-dev：WebKitGTK 4.1 开发头文件，Tauri v2 在 Linux 上承载 WebView 的核心依赖，缺失将直接导致编译失败；
• libappindicator3-dev：系统托盘（Tray）图标支持所需库，对应仓库crates/tauri/src/tray/的托盘实现；
• librsvg2-dev：SVG 渲染库，用于应用图标与资源处理；
• libssl-dev：OpenSSL 开发头文件，供请求、签名等涉及 TLS 的组件链接；
• curl / wget：网络工具，供后续安装脚本与开发调试使用。

该依赖列表与 Tauri v2 官方 Linux 前置条件保持一致（Dockerfile 注释中亦标注了依据CONTRIBUTING.md的开发指南与官方前置条件页面）。

文件系统性能优化：将源码克隆进容器卷

Docker 在主机与容器之间共享文件时存在明显的 I/O 开销，cargo build、pnpm install等大量读写的操作如果直接在共享目录上执行会非常缓慢。因此官方 README强烈建议（可选但高度推荐）使用Clone Repository in Container Volume方式：将 Tauri 源码克隆到容器自身的卷中，而非挂载主机目录。

操作方式：在 VS Code 中打开项目后，从命令面板（F1）执行Remote-Containers: Clone Repository in Container Volume...。克隆完成后，所有构建产物的读写都发生在容器本地卷内，能显著提升编译与安装速度。

在 devcontainer 中运行并显示 Tauri GUI

Tauri 应用本质上是带 GUI 的程序，而在容器内运行 GUI 需要将显示输出转发到 Docker 主机的 X Window server。Docker Desktop 提供了容器访问主机服务的通道（即host.docker.internal），配合主机上运行的 X server，即可将容器中的 Tauri 窗口显示到主机桌面。

关键操作：在你启动 Tauri 应用的 devcontainer 终端里，先导出DISPLAY环境变量：

export DISPLAY="host.docker.internal:0"

执行该命令后，终端中运行cargo tauri dev或cargo run启动的应用，其窗口将通过 X11 协议显示在 Docker 主机的桌面上。需要注意：该导出仅对当前终端会话生效，每次新建终端都需要重新执行；如果主机 X server 使用的不是默认的:0显示编号，请按实际编号调整。

从源码仓库验证容器配置的完整性

• 容器内置的 Node 与 Rust 工具链，对应仓库 pnpm workspace（见 package.json 的build、test等脚本）与 Rust workspace（见 Cargo.toml 中crates/tauri、crates/tauri-cli、packages/cli等成员），进入容器后可直接执行仓库根级的cargo build与pnpm install；
• WebKitGTK 4.1 依赖对应仓库中 Tauri v2 的 Linux WebView 实现（crates/tauri-runtime-wry/src/webview.rs 等模块），缺失该库时容器构建阶段即可发现，避免进入编译期再报错；
• .github/CONTRIBUTING.md中"Development Guide"一节引用的官方前置条件页面，与 Dockerfile 注释所指向的依赖清单一致，两者共同保证了容器内环境与 Tauri 官方推荐开发环境对齐。

结语

这套 devcontainer 配置为 Tauri 源码贡献者提供了"即开即用"的开发环境：Ubuntu 基础镜像 + Tauri v2 Linux 构建依赖 + Node/Rust 双工具链，配合容器卷克隆与 X11 转发，即可在隔离环境中完成编译、运行与 GUI 调试全流程。如果你在搭建过程中遇到问题，官方建议优先查阅 Microsoft VS Code 的容器开发文档，并向 Tauri 仓库提交修正 PR。

• 桌面应用
• 跨平台
• 移动开发