tauri windows环境设置
Tauri 2 轻量级的桌面应用框架 用前端技术(HTML/CSS/JS)开发 UI ,用 Rust 编写后端逻辑
环境配置:搭建 Tauri 开发所需要的基础的运行环境
项目创建:如何使用
create-tauri-app快速初始化一个 Tauri 2.0 项目目录说明:解释项目生成后的核心目录结构和文件作用
一、环境配置
开发环境中安装组件
安装 Microsoft C++ 构建工具: 适用于 C++ 的 Visual Studio 生成工具 下载 Microsoft C++ 构建工具,在安装器中选择“使用 C++ 进行桌面开发” //visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/
如果您已经安装了 Visual Studio,可以通过 Visual Studio Installer 找到并安装此工作负载
安装 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
安装 Rust 编程语言:访问 Rust 官网,下载并运行
rustup-init.exehttps://rust-lang.org/zh-CN/tools/install/配置环境变量:确保将
C:\Users\你的用户名\.cargo\bin 添加到系统的PATH环境变量中注意:如果已经安装过 Rust,请验证
cargo --version命令是否可用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出现提示时输入 Y 确认 在某些情况下,可能需要重启计算机
虽然 npm 是 Node.js 的默认包管理器 使用 pnpm 或 yarn 等其他工具要启用 请在终端中运行corepack enable
此步骤是可选的,仅在您偏好使用非 npm 的包管理器时才需要安装 Tauri CLI:全局安装 Tauri 的命令行工具
npm install -g @tauri-apps/cli
环境配置是 Tauri 开发的基石,特别是 C++ 构建工具和 Rust,缺一不可。如果安装过程中遇到问题,首先检查 PATH 环境变量是否正确配置
windows install bun Using npm If Node.js is installed
npm i -g bunadded 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 --version1.4.2
Upgrade later using bun upgrade
二、创建项目
环境配置完成后,就可以通过 create-tauri-app 脚手架快速创建一个新项目。
运行创建命令:
pnpm create tauri-appcreate-tauri-app 支持多种前端框架模板,如 Vue.js、React、Svelte 等,也可以选择纯 HTML/CSS/JS。
更多社区模板可在 Awesome Tauri 仓库 中查找
//github.com/tauri-apps/awesome-tauri填写项目信息:按照命令行提示,输入项目名称,并选择一个您熟悉的前端模板
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
项目创建配置界面启动开发服务器:
cd tauri-app bun install bun tauri dev
bun install:安装项目依赖(包括前端和后端的依赖)。
bun tauri dev:启动 Tauri 的开发模式,它会同时启动前端开发服务器和 Rust 后端,并弹出一个桌面应用窗口。
验证结果:启动成功后,将弹出一个包含您前端页面的桌面应用程序窗口
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三、文件目录说明
项目创建成功后,主要的目录结构如下
目录/文件 | 作用 |
|---|---|
| 前端源码目录,存放您的 Vue、React 或纯 HTML/CSS/JS 代码。 |
| 前端使用的静态资源(如图片、字体、样式文件等)。 |
| Tauri 后端源码目录,也是 Rust 项目的根目录。 |
| Rust 源码目录,用于编写后端逻辑、命令和状态管理。 |
| 存放应用程序的图标资源。 |
| Tauri 2.0 中用于配置应用的功能和权限声明文件。 |
| 代码生成目录,包含自动生成的数据结构和验证模式。 |
| Rust 项目的构建输出目录( |
常见坑: 很多初学者会忽略 /src-tauri/capabilities 目录
在 Tauri 2.0 中,您必须在此目录下声明应用所需的权限(如文件系统访问、HTTP 请求等)
否则相关功能将无法正常运行
最后
Tauri 2.0 项目的完整流程
上一篇: Tauri是 什么
下一篇: PowerShell PNPM 安装
