tauri windows环境设置

来源:Tauri 教程 / 时间:2026-09-10

Tauri 2 轻量级的桌面应用框架 用前端技术(HTML/CSS/JS)开发 UI ,用 Rust 编写后端逻辑

  1. 环境配置:搭建 Tauri 开发所需要的基础的运行环境

  2. 项目创建:如何使用 create-tauri-app 快速初始化一个 Tauri 2.0 项目

  3. 目录说明:解释项目生成后的核心目录结构和文件作用

一、环境配置

开发环境中安装组件

  1. 安装 Microsoft C++ 构建工具: 适用于 C++ 的 Visual Studio 生成工具 下载 Microsoft C++ 构建工具,在安装器中选择“使用 C++ 进行桌面开发” //visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/

    • 如果您已经安装了 Visual Studio,可以通过 Visual Studio Installer 找到并安装此工作负载

  2. 安装 WebView2 运行时:Tauri 依赖 WebView2 来渲染前端界面。Windows 10(版本 1803 及以上)​ 和 Windows 11​ 已默认包含 为了确保兼容性,建议从 WebView2 官方下载页面 安装或更新

    //developer.microsoft.com/zh-cn/microsoft-edge/webview2/?form=MA13LH&cs=3511774368#download 常青独立安装程序一个成熟的安装程序,可以在离线环境中安装常青运行时。适用于 x86/x64/ARM64

  3. 安装 Rust 编程语言:访问 Rust 官网,下载并运行 rustup-init.exe https://rust-lang.org/zh-CN/tools/install/

  4. 配置环境变量:确保将 C:\Users\你的用户名\.cargo\bin​ 添加到系统的 PATH 环境变量中

    注意:如果已经安装过 Rust,请验证 cargo --version 命令是否可用

  5. Node.js JavaScript 生态系统 仅当您打算使用 JavaScript 前端框架时需要 前往 Node.js 官网 https://nodejs.org/en/blog/release/
    下载并安装长期支持 (LTS) 版本 https://nodejs.org/en/blog/release/v24.21.0 Node.js 24.21.0 (LTS)
    https://nodejs.org/dist/v24.21.0/node-v24.21.0-x64.msi
    运行以下命令检查 Node 是否安装成功:终端窗口
    node -v
    # v20.10.0
    npm -v
    # 10.2.3
    npm : 无法加载文件 d:\nodejs\npm.ps1 解决方法 更改 PowerShell 执行策略 通过更改执行策略为 RemoteSigned,允许运行本地脚本 步骤:以管理员身份打开 PowerShell 输入以下命令并按回车

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
  1. 出现提示时输入 Y 确认 在某些情况下,可能需要重启计算机
    虽然 npm 是 Node.js 的默认包管理器 使用 pnpm 或 yarn 等其他工具要启用 请在终端中运行

    corepack enable 


    此步骤是可选的,仅在您偏好使用非 npm 的包管理器时才需要

  2. 安装 Tauri CLI:全局安装 Tauri 的命令行工具

    npm install -g @tauri-apps/cli
    

环境配置是 Tauri 开发的基石,特别是 C++ 构建工具和 Rust,缺一不可。如果安装过程中遇到问题,首先检查 PATH 环境变量是否正确配置

  1. windows install bun Using npm If Node.js is installed

npm i -g bun

added 2 packages in 8s
npm warn install-scripts 1 package had install scripts blocked because they are not covered by allowScripts:
npm warn install-scripts bun@1.4.2 (postinstall: node install.js)
npm warn install-scripts
npm warn install-scripts Run

npm install -g --allow-scripts=bun
to allow these scripts once, or
npm config set allow-scripts=bun --location=user
to allow them for all global installs.

Verify installation with

bun --version

1.4.2
Upgrade later using bun upgrade

二、创建项目

环境配置完成后,就可以通过 create-tauri-app 脚手架快速创建一个新项目。

  1. 运行创建命令:

    pnpm create tauri-app
  2. create-tauri-app​ 支持多种前端框架模板,如 Vue.js、React、Svelte 等,也可以选择纯 HTML/CSS/JS。
    更多社区模板可在 Awesome Tauri 仓库 中查找
    //github.com/tauri-apps/awesome-tauri

  3. 填写项目信息:按照命令行提示,输入项目名称,并选择一个您熟悉的前端模板
    ​pnpm create tauri-app
    Follow along with the prompts to choose your project name, frontend language, package manager, and frontend framework, and frontend framework options if applicable.
    Not sure what to choose?
    We recommend starting with the vanilla template (HTML, CSS, and JavaScript without a frontend framework) to get started. You can always integrate a frontend framework later.
    Choose which language to use for your frontend: TypeScript / JavaScript
    Choose your package manager: bun
    Choose your UI template: Vanilla
    Choose your UI flavor: TypeScript

    项目创建配置界面

  4. 启动开发服务器:

    cd tauri-app
    bun install
    bun tauri dev
    
    • ​bun install:安装项目依赖(包括前端和后端的依赖)。

    • ​bun tauri dev:启动 Tauri 的开发模式,它会同时启动前端开发服务器和 Rust 后端,并弹出一个桌面应用窗口。

  5. 验证结果:启动成功后,将弹出一个包含您前端页面的桌面应用程序窗口

Building
To build and bundle your app into a Windows installer you can use the Tauri CLI and run the tauri build command in a Windows compute

 bun tauri build

三、文件目录说明

项目创建成功后,主要的目录结构如下

目录/文件

作用

​/src

前端源码目录,存放您的 Vue、React 或纯 HTML/CSS/JS 代码。

​/src/assets

前端使用的静态资源(如图片、字体、样式文件等)。

​/src-tauri

Tauri 后端源码目录,也是 Rust 项目的根目录。

​/src-tauri/src

Rust 源码目录,用于编写后端逻辑、命令和状态管理。

​/src-tauri/icons

存放应用程序的图标资源。

​/src-tauri/capabilities

Tauri 2.0 中用于配置应用的功能和权限声明文件。

​/src-tauri/gen

代码生成目录,包含自动生成的数据结构和验证模式。

​/src-tauri/target

Rust 项目的构建输出目录(.gitignore 中已被排除)。

常见坑: 很多初学者会忽略 /src-tauri/capabilities 目录
在 Tauri 2.0 中,您必须在此目录下声明应用所需的权限(如文件系统访问、HTTP 请求等)
否则相关功能将无法正常运行

最后

Tauri 2.0 项目的完整流程

标签: 环境搭建

上一篇: Tauri是 什么

下一篇: PowerShell PNPM 安装

客服