file-storage

name: file-storage description: | Tauri 文件操作技能,覆盖 Rust std::fs 和 Tauri FS Plugin 的文件读写。

触发场景:

• 需要读写本地文件
• 需要选择文件/目录(对话框)
• 需要管理应用数据目录
• 需要处理文件拖放

触发词: 文件、读写、保存、打开、目录、文件系统、fs、拖放、导入、导出

Tauri 文件操作

两种文件操作方式

方式 1: Rust 文件操作(推荐)

读写文件

use std::fs;
use std::path::PathBuf;

#[tauri::command]
fn read_text_file(path: String) -> Result<String, String> {
    fs::read_to_string(&path).map_err(|e| format!("读取失败: {}", e))
}

#[tauri::command]
fn write_text_file(path: String, content: String) -> Result<(), String> {
    fs::write(&path, &content).map_err(|e| format!("写入失败: {}", e))
}

#[tauri::command]
fn read_json_file<T: serde::de::DeserializeOwned>(path: String) -> Result<T, String> {
    let content = fs::read_to_string(&path).map_err(|e| e.to_string())?;
    serde_json::from_str(&content).map_err(|e| e.to_string())
}

#[tauri::command]
fn list_directory(path: String) -> Result<Vec<String>, String> {
    let entries = fs::read_dir(&path).map_err(|e| e.to_string())?;
    let names: Vec<String> = entries
        .filter_map(|entry| entry.ok())
        .map(|entry| entry.file_name().to_string_lossy().into())
        .collect();
    Ok(names)
}

应用数据目录

#[tauri::command]
fn get_app_data_dir(app: tauri::AppHandle) -> Result<String, String> {
    app.path()
        .app_data_dir()
        .map(|p| p.to_string_lossy().into())
        .map_err(|e| e.to_string())
}

方式 2: Tauri FS Plugin

安装

# Cargo.toml
tauri-plugin-fs = "2"
# package.json
pnpm add @tauri-apps/plugin-fs

Capabilities 权限

{
  "permissions": [
    "fs:default",
    "fs:allow-read-text-file",
    "fs:allow-write-text-file",
    "fs:allow-exists",
    "fs:allow-mkdir"
  ]
}

TypeScript 使用

import { readTextFile, writeTextFile, exists, mkdir } from "@tauri-apps/plugin-fs";
import { appDataDir, join } from "@tauri-apps/api/path";

// 读取文件
const content = await readTextFile("config.json", { baseDir: BaseDirectory.AppData });

// 写入文件
await writeTextFile("output.txt", "Hello World", { baseDir: BaseDirectory.AppData });

// 检查文件存在
const fileExists = await exists("config.json", { baseDir: BaseDirectory.AppData });

文件对话框

安装 Dialog 插件

tauri-plugin-dialog = "2"
pnpm add @tauri-apps/plugin-dialog

打开/保存对话框

import { open, save } from "@tauri-apps/plugin-dialog";

// 选择文件
const selected = await open({
  multiple: false,
  filters: [{ name: "Text", extensions: ["txt", "md"] }],
});
if (selected) {
  const content = await invoke<string>("read_text_file", { path: selected });
}

// 保存文件
const savePath = await save({
  defaultPath: "output.txt",
  filters: [{ name: "Text", extensions: ["txt"] }],
});
if (savePath) {
  await invoke("write_text_file", { path: savePath, content: "data" });
}

常见路径 API

import { appDataDir, appConfigDir, homeDir, desktopDir } from "@tauri-apps/api/path";

const dataDir = await appDataDir();    // 应用数据目录
const configDir = await appConfigDir(); // 应用配置目录
const home = await homeDir();          // 用户主目录
const desktop = await desktopDir();    // 桌面目录

常见错误