在 Tauri 中，插件是扩展应用能力的主要方式（如访问文件系统、操作系统通知、全局快捷键等）。多数官方和社区插件都经过良好的跨平台适配，你只需关心如何注册和配置它们。
插件注册
Tauri 的插件分两部分联动：Rust 端注册 和 前端 JS 绑定。
- 安装插件
通过 Cargo（Rust 包管理）和 npm 分别安装。以官方文件系统插件 tauri-plugin-fs 为例：
cargo add tauri-plugin-fs
npm install @tauri-apps/plugin-fs
- Rust 端注册
在 src-tauri/src/lib.rs（或 main.rs）的 tauri::Builder 中调用 .plugin() 方法注册：
fn main() {
tauri::Builder::default()
.plugin(tauri_plugin_fs::init())
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
这一步让 Rust 内核加载插件提供的命令和权限定义。
- 前端启用
在前端代码中直接导入即可使用：
import { readTextFile } from '@tauri-apps/plugin-fs';
参数配置
插件的行为通常通过 权限配置（capabilities）和 插件初始化参数 控制。
- 权限配置
Tauri v2 采用“能力”(capability)模式，你需要为应用声明允许使用的命令和作用域。在 src-tauri/capabilities/default.json（或自定义文件）中：
{
"identifier": "default",
"windows": ["main"],
"permissions": [
"fs:allow-read-text-file",
"fs:allow-write-text-file",
{
"identifier": "fs:scope",
"allow": [{ "path": "$HOME/**" }]
}
]
}
这样明确规定了前端只能读写 $HOME 下的文件，其他路径一律拒绝。安全且可控。
- 插件初始化参数
部分插件在 .plugin() 注册时可以传入配置对象。例如 tauri-plugin-log 可设置日志级别：
.plugin(tauri_plugin_log::Builder::new().level(log::LevelFilter::Info).build())
这些参数通常在文档的“安装”部分会详细列出。
跨平台兼容
绝大多数官方插件已经处理好了平台差异，你无需额外适配。但有几个实用点需要留意：
- 条件编译
Rust 端可以使用 cfg 属性为不同平台编写特定逻辑。这在自定义插件或需要调用平台专有 API 时非常实用：
#[cfg(target_os = "windows")]
fn platform_specific() { /* Windows 代码 */ }
- 文件路径分隔符
插件内部默认使用 / 作为路径分隔符，但与操作系统交互时会自动转换。在前端传递路径时建议统一使用正斜杠，避免 \ 被转义。
- macOS 沙盒与权限
若计划上架 Mac App Store，需要启用沙盒并声明相应 entitlements。官方插件的文档通常会注明是否需要额外配置（如文件访问、网络等）。你可以在 tauri.conf.json 的 bundle > macOS 中设置。
- Linux WebView 差异
Linux 发行版使用的 WebKitGTK 版本可能不同，但 Tauri 插件本身不受此影响。只需确保目标系统安装了推荐的 libwebkit2gtk 版本即可（构建时会有提示）。
一句话总结：插件注册只需在 Rust 和前端各安装一次，然后按需配置能力权限；官方插件对头三个桌面平台都有完善的支持，你可以在配置文件中以最小的代价实现安全的跨平台功能。