【Tauri 2 + Rust 配置 WebView2 缓存数据存储到安装目录】

一、背景与需求

在使用 Tauri 2 开发 Windows 桌面应用时，默认情况下 WebView2（基于 Microsoft Edge Chromium）会将缓存、Cookies、LocalStorage、IndexedDB 等用户数据存储在系统 %LOCALAPPDATA% 目录下。这对便携化应用或希望所有数据统一存放在安装目录的应用非常不友好。

本文详细介绍如何通过 Rust 代码将 WebView2 的 User Data Folder（数据目录）设置为安装目录下的子文件夹，并提供完整的缓存清理方案。

---

二、核心解决方案：使用 data_directory 设置绝对路径

Tauri 2 的 WebviewWindowBuilder 提供了 data_directory 方法，可传入绝对路径来覆盖默认行为。这是实现便携化的关键。

1. 推荐代码实现（src-tauri/src/main.rs）

use tauri::{Manager, WebviewUrl, WebviewWindowBuilder};
use std::path::PathBuf;

#[tauri::command]
fn greet(name: String) -> String {
    format!("Hello, {}! You've been greeted from Rust!", name)
}

fn main() {
    tauri::Builder::default()
        .setup(|app| {
            // ==================== 1. 获取安装目录 ====================
            let exe_path = std::env::current_exe()
                .expect("Failed to get current exe");
            let install_dir = exe_path.parent()
                .expect("Failed to get parent dir")
                .to_path_buf();

            // ==================== 2. 创建数据目录（强烈推荐子文件夹） ====================
            let data_dir = install_dir.join("WebView2Data");  // 或 "Data"、"UserData" 等
            
            // 确保目录存在并有写入权限
            if let Err(e) = std::fs::create_dir_all(&data_dir) {
                eprintln!("Failed to create data directory: {}", e);
            }

            println!("WebView2 Data Directory: {:?}", data_dir);

            // ==================== 3. 创建主窗口并设置数据目录 ====================
            let main_window = WebviewWindowBuilder::new(
                app,
                "main",  // 窗口 label，必须唯一
                WebviewUrl::App("index.html".into()),  // 你的前端入口
            )
            .title("我的 Tauri 应用")
            .inner_size(1200.0, 800.0)
            .data_directory(data_dir)   // ← 关键设置：绝对路径
            .build()?;

            // 可选：其他窗口配置
            // main_window.set_decorations(false)?; // 无边框
            // main_window.set_resizable(true)?;

            Ok(())
        })
        .invoke_handler(tauri::generate_handler![greet])
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

---

三、详细配置说明与注意事项

1. 为什么必须用绝对路径？
   tauri.conf.json 中的 dataDirectory 是相对路径（基于 AppData），无法直接指向安装目录。必须在 Rust 的 setup 阶段使用 data_directory(PathBuf)。

2. 安装目录获取方式对比：

   • std::env::current_exe() → 最推荐（打包后最稳定）
   • app.path().resource_dir() → 适合资源文件
   • tauri::path::BaseDirectory::App → 通常指向 AppData，不推荐用于便携

3. 权限问题处理：

   • 避免直接把数据目录设在 C:\Program Files 根目录（UAC 限制）。
   • 最佳实践 ：安装目录下创建 WebView2Data 子文件夹。
   • 打包时使用 NSIS / WiX / Inno Setup，确保安装程序对该文件夹授予写入权限。

4. 多窗口场景 ：

   每个窗口建议使用独立的 data_directory，或共享同一个（需注意进程隔离）。

5. tauri.conf.json 辅助配置（可选）：

   {
     "app": {
       "windows": [
         {
           "label": "main",
           "fullscreen": false,
           "resizable": true
         }
       ]
     }
   }

---

四、WebView2 缓存清理方法

方法一：手动删除文件夹（开发/调试最常用）

• 关闭应用
• 删除安装目录下的 WebView2Data 文件夹（或其子目录 EBWebView）
• 重启应用，WebView2 会自动重新创建

重点清理路径 （相对于你的 data_dir）：

• EBWebView/Default/Cache/ → 网页缓存
• EBWebView/Default/Cookies → Cookie
• EBWebView/Default/IndexedDB/ → IndexedDB
• EBWebView/Default/Local Storage/ → LocalStorage

方法二：通过 WebView2 API 编程清除（推荐生产环境）

在前端 JavaScript 中调用（需暴露命令）：

// Rust 侧暴露命令
#[tauri::command]
async fn clear_webview_cache(window: tauri::Window) -> Result<(), String> {
    if let Some(webview) = window.webview() {
        // 使用 CoreWebView2 执行清除
        // 更完整方式可通过 tauri 插件或直接调用
        webview.eval(r#"
            // 清空 LocalStorage / SessionStorage
            localStorage.clear();
            sessionStorage.clear();
            
            // 清除 IndexedDB（需逐个数据库处理）
            console.log('缓存清理完成');
        "#).map_err(|e| e.to_string())?;
    }
    Ok(())
}

更彻底的清除（推荐使用 Microsoft 官方 ClearBrowsingData API）：

需要通过 CoreWebView2 环境对象调用（Tauri 2 可通过 webview.with_webview 访问底层）：

.use tauri::webview::Webview;
.window.with_webview(|webview| {
    // 这里是平台特定代码，Windows 下可访问 CoreWebView2
});

方法三：打包卸载时自动清理

在 NSIS 安装脚本中添加：

Section "Uninstall"
    RMDir /r "$INSTDIR\WebView2Data"
    ; ...
SectionEnd

---

五、常见问题排查

• WebView2 启动失败 ：检查 data_directory 是否有写入权限，尝试临时切换到 %LOCALAPPDATA% 测试。
• 缓存不生效 ：确保每次只使用一个 data_directory，不同参数的 WebView 不能共享同一文件夹。
• 开发环境 vs 打包环境 ：开发时 cargo tauri dev 的 exe 位置与打包后不同，建议打印路径调试。
• 多用户场景 ：若需支持多用户，可在 data_dir 下再按用户名创建子文件夹。

---

六、总结

通过 WebviewWindowBuilder::data_directory 将 WebView2 用户数据目录指向安装目录下的子文件夹，即可实现真正的便携化应用。结合手动删除 + 编程清除缓存的方法，能很好地控制应用数据体积和隐私。

完整项目建议结构：

MyApp/
├── src-tauri/
│   └── src/main.rs
├── WebView2Data/          ← 运行时自动生成
├── dist/                  ← 前端构建
└── tauri.conf.json

欢迎大家在评论区留言遇到的问题，我会尽量帮忙解答。

---

参考资料：

• Tauri 2 官方文档（WebviewWindowBuilder）
• Microsoft WebView2 User Data Folder 最佳实践
• StackOverflow & GitHub 相关讨论

文章标签：Tauri、Rust、WebView2、桌面应用、便携化、缓存清理

---

如果你需要完整项目模板、NSIS 打包脚本或其他平台（macOS WKWebView / Linux WebKit）对应方案，欢迎私信或评论告诉我！