用途 该技能面向 Tauri v2 应用中的本地文件读写需求,提供使用 file-system 插件并配置带作用域目录访问的完整流程。当涉及在 Tauri 应用中读取或写入本地文件、为安全访问配置文件系统作用域、以及实现文件导入/导出工作流时使用。触发关键词包括 file system、read file、write file、fs plugin、file access、scope。
主要能力 安装 file-system 插件(cargo add tauri-plugin-fs);在 Tauri Builder 中注册插件;在配置文件中设置作用域访问权限;在前端执行文件读写操作。技能给出的输出物包括:带作用域目录访问的文件系统插件配置、使用 BaseDirectory 常量的读写操作,以及最小作用域权限配置。
使用方式
- 安装插件:cargo add tauri-plugin-fs。
- 在 Tauri Builder 中注册插件:
tauri::Builder::default() .plugin(tauri_plugin_fs::init())
- 在 src-tauri/capabilities/default.json 中配置作用域访问:
{ "permissions": [ { "identifier": "fs:allow-read-text-file", "allow": [{ "path": "$APPDATA/" }] }, { "identifier": "fs:allow-write-text-file", "allow": [{ "path": "$APPDATA/" }] } ] }
- 在前端进行读写:
import { readTextFile, writeTextFile, BaseDirectory } from '@tauri-apps/plugin-fs'; const content = await readTextFile('config.json', { baseDir: BaseDirectory.AppData }); await writeTextFile('config.json', JSON.stringify(data), { baseDir: BaseDirectory.AppData });
- 定义最小目录作用域,仅将访问限制在应用实际需要的目录。
- 校验访问边界,并优雅地处理权限错误。
适用场景 在 Tauri v2 应用中实现本地文件读取与写入、配置文件系统作用域以实现安全访问、实现文件导入/导出流程等场景。
限制与注意 应定义最小化的目录作用域,避免开放不必要的目录;需校验访问边界并妥善处理权限错误。
参考 https://v2.tauri.app/plugin/file-system/