开发 on 编程那些事儿

1 开发概述

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/

现在你已完成全部准备，可以运行你的 Tauri 应用了。

如果你使用 UI 框架或 JavaScript 打包工具，通常会有一个开发服务器来加速开发流程。因此如果你还没配置应用的开发 URL 和启动脚本，可以通过 devUrl 和 beforeDevCommand 配置项来设置：

2 配置文件

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/configuration-files/

由于 Tauri 是构建应用的框架，配置项目设置时可能涉及许多文件。你可能会遇到的一些常见文件有 tauri.conf.json、package.json 和 Cargo.toml。本页会简要说明每一个，帮助你在需要修改时找对文件。

3 从前端调用 Rust

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/calling-rust/

本文档介绍如何从应用前端与 Rust 代码通信。如果想了解如何从 Rust 代码与前端通信，请参阅从 Rust 调用前端。

Tauri 提供了带类型安全的、用于调用 Rust 函数的命令原语，以及更动态的事件系统。

4 从 Rust 调用前端

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/calling-frontend/

本文档介绍如何从 Rust 代码与应用前端通信。如果想了解如何从前端与 Rust 代码通信，请参阅从前端调用 Rust。

Tauri 应用的 Rust 侧可以通过 Tauri 事件系统调用前端，也可以使用通道，或直接执行 JavaScript 代码。

5 状态管理

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/state-management/

在 Tauri 应用中，你经常需要跟踪应用的当前状态，或者管理与应用相关联事物的生命周期。Tauri 通过 Manager API 提供了一种简单的方式来管理应用状态，并在命令被调用时读取它。

5 嵌入附加文件

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/resources/

你可能需要在应用打包中加入一些不属于前端（即你的 frontendDist）的文件，或者文件太大不适合内联进二进制文件。我们把这类文件称为 resources（资源）。

7 嵌入外部二进制文件

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/sidecar/

你可能需要嵌入外部二进制文件来为应用添加额外功能，或者避免用户去安装额外依赖（例如 Node.js 或 Python）。我们把这类的二进制文件称为 sidecar。

8 更新依赖

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/updating-dependencies/

更新 npm 包

如果你使用 tauri 包：

包管理器

1

npm install @tauri-apps/cli@latest @tauri-apps/api@latest

1

yarn up @tauri-apps/cli @tauri-apps/api

1

pnpm update @tauri-apps/cli @tauri-apps/api --latest

你也可以在命令行中查看 Tauri 的最新版本：

9 应用图标

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/icons/

Tauri 自带一套基于其 logo 的默认图标集。发布应用时这并不是你想要的。为解决这个常见问题，Tauri 提供了 icon 命令：它以某个输入文件（默认是 "./app-icon.png"）为基础，生成各平台所需的所有图标。

1 调试概述

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/debug/

Tauri 涉及的环节很多，你可能会遇到需要调试的问题。有许多地方会打印错误细节，Tauri 也提供了一些工具来让调试过程更直接。

仅在开发环境使用的代码

调试工具箱中最有用的工具之一，是能在代码里添加调试语句。不过你通常不希望它们进入生产环境，这时判断自己是否运行在开发模式下就派上用场了。

2 CrabNebula DevTools

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/debug/crabnebula-devtools/

CrabNebula 作为与 Tauri 项目合作的一部分，为 Tauri 提供了一个免费的 DevTools 应用。该应用可以对你的 Tauri 应用进行插桩：捕获其内嵌资源、Tauri 配置文件、日志与 span，并提供一个 Web 前端来实时无缝地可视化这些数据。

3 Linux 图形问题

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/debug/linux-graphics/

在 Linux 上，Tauri 通过 WebKitGTK 渲染。在某些环境下（最常见的是 NVIDIA GPU），WebKitGTK 与显卡驱动无法达成一致，你会遇到从空白窗口到细微渲染问题等各种现象。本页汇总了已知症状与变通办法。原始报告见 tauri-apps/tauri#9394。

4 在 JetBrains IDE 中调试

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/debug/rustrover/

在本指南中，我们将配置 JetBrains RustRover 来调试 Tauri 应用的核心进程。其中大部分内容也适用于 IntelliJ 和 CLion。

设置 Cargo 项目

取决于项目使用的前端技术栈，项目目录可能是也可能不是 Cargo 项目。默认情况下，Tauri 把 Rust 项目放在名为 src-tauri 的子目录中。只有当 Rust 也用于前端开发时，它才会在根目录创建 Cargo 项目。

5 在 VS Code 中调试

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/debug/vscode/

本指南将带你配置 VS Code，用于调试 Tauri 应用的核心进程。

使用 vscode-lldb 扩展的所有平台

前置条件

安装 vscode-lldb 扩展。

配置 launch.json

创建 .vscode/launch.json 文件，并把下面的 JSON 内容粘贴进去：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


{
 // 使用 IntelliSense 了解可能的属性。
 // 悬停可查看现有属性的说明。
 // 更多信息请访问：https://go.microsoft.com/fwlink/?linkid=830387
 "version": "0.2.0",
 "configurations": [
 {
 "type": "lldb",
 "request": "launch",
 "name": "Tauri Development Debug",
 "cargo": {
 "args": [
 "build",
 "--manifest-path=./src-tauri/Cargo.toml",
 "--no-default-features"
 ]
 },
 // 如果使用了 `beforeDevCommand`，其任务必须在 `.vscode/tasks.json` 中配置
 "preLaunchTask": "ui:dev"
 },
 {
 "type": "lldb",
 "request": "launch",
 "name": "Tauri Production Debug",
 "cargo": {
 "args": ["build", "--release", "--manifest-path=./src-tauri/Cargo.toml"]
 },
 // 如果使用了 `beforeBuildCommand`，其任务必须在 `.vscode/tasks.json` 中配置
 "preLaunchTask": "ui:build"
 }
 ]
}

它直接使用 cargo 构建 Rust 应用，并在开发模式和生产模式下加载它。

6 在 Neovim 中调试

Fri, 25 Sep 2026 21:31:08 +0800

原文链接: https://tauri.app/develop/debug/neovim/

在 Neovim 中调试 Rust 代码有很多不同的插件可用。本指南将展示如何配置 nvim-dap 以及一些附加插件来调试 Tauri 应用。

前置条件

nvim-dap 扩展需要 codelldb 二进制文件。请从 https://github.com/vadimcn/codelldb/releases 下载适合你系统的版本并解压。稍后我们会在 nvim-dap 配置中指向它。