在开发 Tauri 应用时，一个非常容易踩坑的问题就是路径不一致：在 tauri dev 开发模式下运行得好好的，打包成正式安装包后，应用却找不到文件、报出路径错误。这背后是工作目录和资源定位方式的根本差异。
为什么开发环境和打包后路径不同？
- 开发环境
tauri dev 启动时，Rust 后端的工作目录通常是项目的根目录（也就是 src-tauri 的父目录）。如果你在代码里用相对路径 ./data/config.json 读取文件，它会相对于项目源码目录去寻找。这对于调测非常方便，而且恰好能用。
- 打包后
应用被编译为二进制，安装到 C:\Program Files\YourApp 或 /Applications/YourApp.app/Contents/MacOS/。此时 工作目录往往是用户运行应用的当前目录（可能是桌面、用户主目录等），而不再是你放资源的那个位置。相对路径会完全失效。更糟的是，在 macOS 的 .app 包中，工作目录常被设为根目录 /，极易导致权限问题。
如何可靠地定位资源文件？
最关键的原则：不要依赖相对路径，改用 Tauri 提供的路径 API。
Tauri 为 Rust 后端和前端分别提供了获取应用资源目录的方法，这些方法在开发环境和打包后都能返回正确的位置。
1. 在 Rust 后端获取资源路径
利用 tauri::App 的 path 端点，可以获取各种标准目录，例如：
app.path().resource_dir()— 应用的resources目录（打包时会包含你放在tauri.conf.json > bundle > resources里的文件）。app.path().app_config_dir()— 应用的配置目录，适合存放用户配置文件。app.path().app_data_dir()— 应用的数据目录，适合存放用户数据。
示例：安全读取资源文件
#[tauri::command]
fn read_config(app: tauri::AppHandle) -> Result<String, String> {
let resource_dir = app.path().resource_dir().map_err(|e| e.to_string())?;
let config_path = resource_dir.join("config.json");
std::fs::read_to_string(&config_path)
.map_err(|e| format!("无法读取配置文件: {}", e))
}注意：resource_dir() 返回的路径在开发时指向项目目录下的 src-tauri，在生产中指向安装目录下的 resources 文件夹，因此文件放置位置要对齐。
2. 在前端获取资源路径
如果前端需要加载图片、字体等静态资源，通常通过 Web 技术栈相对路径引用（/assets/...） — 这没问题，因为 Vite 打包后会正确内联或放置这些资源。但如果前端需要访问后端提供的本地文件路径（例如显示用户目录下的图片），最佳做法是通过 Rust 命令将路径传回，而不是前端自己猜测。
Tauri 提供 convertFileSrc 辅助函数，可将本地绝对路径转为安全的前端可访问的 URL（需启用 tauri://localhost 协议）。
前端代码：
import { invoke } from '@tauri-apps/api/core';
import { convertFileSrc } from '@tauri-apps/api/tauri';
const filePath = await invoke('get_some_file_path');
const assetUrl = convertFileSrc(filePath);
// 然后可以把 assetUrl 用在 <img src={assetUrl} /> 中3. 使用资源包（resource_dir）的正确配置
如果你有额外的二进制文件或数据文件需要在运行时加载，需在 tauri.conf.json 中声明：
{
"bundle": {
"resources": [
"binaries/*",
"data/config.json"
]
}
}这些文件打包时会复制到对应平台的资源目录，然后通过 app.path().resource_dir() 获取。
常见错误及规避
- 错误： 在代码中硬编码
../somefile或./data.txt
解决： 一律替换为上述路径 API。
- 错误： 在开发时用
std::env::current_dir()定位资源，打包后发现失效
解决： 改用 app.path().resource_dir() 或 app.path().app_config_dir() 等语义化目录。
- 错误： 前端直接访问绝对文件路径，导致跨域或安全限制
解决： 通过 Rust 命令和 convertFileSrc 转换。
- 错误： 忘记在
tauri.conf.json声明资源，导致打包后文件缺失
解决： 确认 bundle.resources 包含所有需要的非编译文件。
一句话总结
用 Tauri 的内置路径 API 代替任何手工拼接的相对路径，是保证应用在开发和生产环境行为一致的最简单方法。 这样你的应用才能像一个真正的桌面软件那样，无论被安装在何处，都能准确找到自己该用的资源。