8.5 TypeScript 类型支持与类型封装

Tauri 对 TypeScript 的支持是一等公民级别的：它不仅能让你安全地调用 Rust 命令，还能自动生成精确的类型定义，让你在前端获得完整的类型提示和错误检查。这种类型保障能显著降低前端与后端间的沟通错误，省去手动编写接口声明的时间。

1. 核心机制：自动类型生成

Tauri CLI 提供了一系列命令，能够根据你的 Rust 代码中暴露的 #[tauri::command] 自动生成 TypeScript 类型声明。最典型的工作流如下：

在 Rust 中定义命令：

  #[tauri::command]
  fn greet(name: &str) -> String {
      format!("Hello, {}!", name)
  }

在构建时或通过 CLI 主动生成类型文件：

  npx tauri typegen

这个命令会扫描你的 Rust 源码，生成类似 bindings.ts 的文件，其中包含了每个命令的参数类型和返回值类型。

生成出的类型通常是这样的：

  // 自动生成的类型声明
  export interface GreetArgs {
    name: string;
  }

  export type InvokeCommand = {
    greet: [GreetArgs, string];   // 参数类型和返回值类型
  };

2. 在项目中使用类型

如果使用 @tauri-apps/api 中封装好的 invoke 函数，你可以直接把自动生成的类型传给一个封装后的调用器，获得完整的类型提示。社区常用库 tauri-plugin-typegen 或 Tauri 官方推出的 tauri-specta（一个类型安全桥接方案）能更进一步简化这个过程。

举个实用例子，假设你生成了类型后，可以自己封装一个简单的 typedInvoke：

import { invoke } from "@tauri-apps/api/tauri";
import type { InvokeCommand } from "./bindings";

export async function typedInvoke<T extends keyof InvokeCommand>(
  cmd: T,
  args: InvokeCommand[T][0]
): Promise<InvokeCommand[T][1]> {
  return invoke(cmd, args);
}

// 使用时：
const result = await typedInvoke("greet", { name: "Alice" });
// result 自动推断为 string，参数有智能提示

这种封装的优点：

所有可用命令自动出现在 IDE 提示中；
参数结构和类型错误在编译阶段就能暴露；
无须手动维护 TypeScript 接口与 Rust 签名的一致性。

3. 更高级的类型封装方案

Tauri Specta：一个专门为 Tauri 设计的库，它能自动导出端到端的类型安全。你在 Rust 中用 specta 标记函数，前端即可生成完全类型匹配的客户端调用函数，甚至支持复杂泛型、枚举和数据类。
手动声明：如果你偏向轻量，也可以为少量命令手写类型，但建议在命令数量超过 10 个后使用自动化工具，否则维护负担会很重。

4. 实际开发建议

对团队来说，将类型生成步骤集成到 package.json 的 build 或 prebuild 脚本中，每次构建前自动同步类型，能有效避免前后端接口不一致导致的线上故障。
如果你的 Tauri 项目使用 Vite 或其他打包工具，可以把生成的类型文件放在 src/types 下，方便统一管理。

一句话总结：Tauri 强大的类型支持，让你在前端调用 Rust 命令时，就像调用一个带类型检查的普通异步函数一样自然，而不必担心参数拼错、返回值类型不匹配等低级问题。