一个很常见的上线事故:开发机上把「记住上次打开的目录」做得好好的,发给同事一测,设置永远是空的。再仔细看,保存按钮其实执行了,配置文件也生成了,只是生成在了一个同事没有写权限的地方。另一个更隐蔽:程序正在写配置的时候用户强制关机,重启后配置文件只剩半截,程序读不出来,直接把所有设置当默认值,用户以为升级把数据弄丢了。

文件操作看起来是最基础的一章,实际上桌面程序的信任问题大多从这里开始。用户不会关心你用了什么框架,只会记住「这个软件把我的设置弄没了」。这篇把三件事讲清楚:数据应该存在哪,怎么写才不会被写坏,出错时怎么让用户看懂。示例全部只用标准库,并且在本机真实编译运行过,输出会原样贴出来。

三个「目录」别混在一起

桌面程序里至少有三个容易混淆的位置。第一个是可执行文件所在目录,也就是 exe 所在的文件夹。第二个是当前工作目录,程序被从哪里启动,这个值就是哪里。第三个是用户数据目录,系统分配给这个应用存配置和缓存的地方。开发时双击运行,这三个目录常常恰好是同一个,所以问题被掩盖了;打包安装以后,它们立刻分开。

exe 目录:只读资源、内置模板、图标,安装后通常没有写权限
工作目录:用户从哪个目录启动程序,可能随时变化,不能当成固定值
用户数据目录:配置、缓存、日志、数据库,每个用户独立,系统保证可写

把配置写在 exe 目录,在开发机上完全正常,装到 Program Files 后就变成「保存失败」,因为普通用户对那个目录没有写权限。把配置写在当前工作目录,用户从桌面图标启动时可能落到系统目录,从命令行启动时又落到别处,于是同一台机器上出现两份配置,谁也说不清哪份是准的。

正确做法是:只读资源跟着 exe 走,可变数据跟着用户走。Windows 上常用的环境变量有三个。APPDATA 指向漫游目录,适合用户希望跟着账号同步的小配置;LOCALAPPDATA 指向本机目录,适合缓存、日志和大文件;USERPROFILE 是用户主目录,除非要做文档类功能,否则不要往根下扔文件。跨平台时不要自己拼字符串,用各平台约定的目录:macOS 是 Application Support,Linux 是 XDG 配置目录。

本机配置实验把文件落在了 C:\Users\c1805\AppData\Local\Temp\科设 文档\Rust桌面\设置.ini,这个路径同时踩中了三个点:中文、空格、多级目录。它用的是 std::env::temp_dir(),不是 LOCALAPPDATA,所以演示里能跑通;真实产品应该把同样的目录结构挂到用户数据目录下,而不是临时目录,否则重启后被清理,用户设置又丢了。

不要假设环境变量一定存在。某些服务账户、精简系统或被修改过的环境里,LOCALAPPDATA 可能为空。取不到时要有回退方案,比如退回临时目录并在界面上提示「本次设置不会保存」,而不是直接 panic。

一个能跑的配置读写

下面这段程序演示完整的一套:中文路径、创建目录、原子写入、读取、坏文件容错、只读文件报错。它只用标准库,直接编译即可:

use std::collections::BTreeMap;
use std::fs;
use std::io::Write;
use std::path::{Path, PathBuf};

fn load(path: &Path) -> BTreeMap<String, String> {
    let mut map = BTreeMap::new();
    if let Ok(text) = fs::read_to_string(path) {
        for line in text.lines() {
            if let Some((key, value)) = line.split_once('=') {
                map.insert(key.trim().to_string(), value.trim().to_string());
            }
        }
    }
    map
}

fn save_atomic(path: &Path, map: &BTreeMap<String, String>) -> std::io::Result<()> {
    let dir = path.parent().unwrap();
    fs::create_dir_all(dir)?;
    let tmp = path.with_extension("tmp");
    let mut file = fs::File::create(&tmp)?;
    for (key, value) in map {
        writeln!(file, "{}={}", key, value)?;
    }
    file.sync_all()?;
    drop(file);
    fs::rename(&tmp, path)?;
    Ok(())
}

fn main() {
    let base = std::env::temp_dir().join("科设 文档").join("Rust桌面");
    let path: PathBuf = base.join("设置.ini");
    let mut cfg = BTreeMap::new();
    cfg.insert("theme".to_string(), "dark".to_string());
    cfg.insert("last_dir".to_string(), r"D:\素材\2024 冬".to_string());

    println!("[path] {}", path.display());
    save_atomic(&path, &cfg).unwrap();
    println!(
        "[save] ok, exists={} tmp_exists={}",
        path.exists(),
        path.with_extension("tmp").exists()
    );

    let loaded = load(&path);
    println!(
        "[load] theme={:?} last_dir={:?}",
        loaded.get("theme"),
        loaded.get("last_dir")
    );

    fs::write(&path, "theme\nbroken line\nfont=14").unwrap();
    let recovered = load(&path);
    println!(
        "[recover] keys={:?} font={:?}",
        recovered.keys().collect::<Vec<_>>(),
        recovered.get("font")
    );

    cfg.insert("font_size".to_string(), "14".to_string());
    save_atomic(&path, &cfg).unwrap();
    println!("[save2] exists={} tmp_exists={}", path.exists(), path.with_extension("tmp").exists());

    let mut perms = fs::metadata(&path).unwrap().permissions();
    perms.set_readonly(true);
    fs::set_permissions(&path, perms).unwrap();
    match save_atomic(&path, &cfg) {
        Ok(()) => println!("[readonly] 意外成功"),
        Err(err) => println!("[readonly] err: {}", err),
    }

    let mut perms = fs::metadata(&path).unwrap().permissions();
    perms.set_readonly(false);
    let _ = fs::set_permissions(&path, perms);
}
rustc -O config_fs.rs
.\config_fs.exe
[path] C:\Users\c1805\AppData\Local\Temp\科设 文档\Rust桌面\设置.ini
[save] ok, exists=true tmp_exists=false
[load] theme=Some("dark") last_dir=Some("D:\\素材\\2024 冬")
[recover] keys=["font"] font=Some("14")
[save2] exists=true tmp_exists=false
[readonly] err: 拒绝访问。 (os error 5)

逐条看输出。第一行证明了带空格和中文的路径可以正常创建和读写,Rust 的 Path 在 Windows 上按宽字符处理,不需要自己做编码转换。第二行说明写入成功后临时文件已经不存在,因为 rename 把它替换成了目标文件。第三行说明读回来的值和写进去的一致,反斜杠也被完整保留。

第四行是最值得警惕的:把文件人为改坏以后,load 没有报错,而是默默丢掉了两行坏数据,只留下能解析的 font=14。这在演示里看起来「容错很好」,在真实产品里却是灾难,因为它把「文件损坏」伪装成了「部分设置丢失」,用户根本不知道该恢复。生产代码里应该区分「文件不存在」和「文件存在但解析失败」,后者要备份原文件、提示用户,而不是静默继续。

看输出时还要注意 [recover] keys=["font"] 这一行:坏掉的两行不是被跳过,而是整份文件被重新解释,能解析的键留下,不能解析的丢掉。表面看是容错,实际是把损坏数据静默降级成部分数据。修法是先读原始字节、校验文件头版本号,再决定是迁移还是备份;只要解析失败的行数超过预期,就应该停下来提示用户,而不是继续写回。

第五行是只读文件的表现:写入返回「拒绝访问」,错误码 5。这个错误在真实场景里很常见:文件被同步软件占用、被另一个进程打开、用户手动设了只读、或者目录权限被组策略限制。界面不能只弹一个「保存失败」,要告诉用户是哪个文件、可能的原因、以及能不能换一个位置。

为什么一定要原子写

直接用 File::create 覆盖原文件,有一个无法回避的窗口期:文件已经被截断,新内容还没写完。这时候断电、蓝屏、进程被杀,原文件就没了。配置越重要,这个窗口越致命。原子写的思路是先写临时文件,写完并落盘,再一次性替换目标文件。替换这一步在同一个磁盘分区上是原子的,要么还是旧文件,要么已经是完整的新文件,不会出现半截。

一次安全的配置写入
确保目录存在
写入同目录的临时文件
刷新到磁盘
重命名覆盖目标文件
失败时保留旧文件

几个细节决定这套方案是否真的可靠。临时文件必须和目标文件在同一个目录、同一个卷,跨卷重命名不是原子操作。写完要 sync_all,否则数据可能还在系统缓存里,重命名成功但内容没落盘。重命名前要关闭文件句柄,Windows 上打开的文件不能被替换。失败路径要清理临时文件,否则目录里会堆积一堆 .tmp。

还有一个常见误区:以为 rename 在 Windows 上不能覆盖已存在的文件。Rust 标准库在 Windows 上用的是带替换标志的移动,目标存在时会被替换,这一点上面的第二次保存已经验证。但如果你绕过标准库直接调系统 API,行为可能不同,别把两套语义混用。

临时文件的命名也有讲究。上面的示例用 with_extension("tmp"),同一目录下只有一个临时文件;如果程序可能被双击两次,两个进程会抢同一个临时文件,一个还在写,另一个已经重命名,结果就是内容互相覆盖。更稳的做法是把进程号或随机串拼进临时文件名,写完再原子替换;清理时只删自己创建的那个文件。

sync_all 会让一次保存多花几毫秒,尤其是机械盘。对配置文件这种几十字节的写入,这个代价可以接受;对每秒写入的日志,就不该每条都同步落盘,否则磁盘会成为瓶颈。区分「必须持久」和「丢了也能重建」的数据,是这一节最实际的取舍。

路径、编码与长文件名

路径处理的第一原则是用 PathBuf 和 Path,不要用字符串相加。字符串相加会漏掉分隔符,也会在跨平台时把反斜杠和正斜杠搞混。拼接用 join,取父目录用 parent,取扩展名用 extension,这些方法在三个平台上都按当地规则工作。

第二原则是区分「显示」和「处理」。to_string_lossy 会把无法表示成 UTF-8 的字符替换掉,用来打日志、显示在界面上没问题,但不要拿它的结果去重新打开文件。真正操作文件时始终保留原始的 PathBuf。Windows 的文件名允许一些 UTF-8 之外的字符组合,转成字符串再转回去可能已经不是同一个路径。

第三原则是注意长路径。Windows 传统路径上限是 260 个字符,超过以后一些 API 会失败。Rust 在较新版本里对长路径的支持取决于系统设置和 API,遇到「路径过长」的错误时,可以先缩短目录层级,或者用扩展长度前缀。这个问题在素材管理、嵌套备份目录里很常见,别等到用户反馈才处理。

长路径还有一层:即使你的 API 支持,资源管理器、压缩工具、同步软件未必支持。用户把目录嵌套十几层以后再反馈「你的软件打不开」,根因可能不在你的代码。能在自己代码里做的,是在拼接前检查总长度,超限时给出明确提示,而不是等系统返回一个笼统的错误。

配置文件本身建议用 UTF-8 保存,并在文件头写一个版本号。读取时如果遇到非 UTF-8 内容,read_to_string 会直接失败,这时要区分「这是旧版本的文件」还是「文件坏了」。给配置加版本号,是后面做迁移的基础:新版本读到版本 1,就知道该走迁移逻辑,而不是把旧键当未知键丢掉。

从需求到跑起来:首次启动与升级

把上面的规则拼成一次完整流程,覆盖首次启动、正常启动、文件损坏、升级四种情况。

计算用户数据目录,取不到则回退并提示
读取配置,不存在则生成默认值
解析失败则备份原文件并告知用户
检查版本号,需要时执行迁移
原子写回,确保只保留一份有效配置

首次启动的验收标准是:目录被创建,默认配置被写入,界面能读到这些默认值。正常启动的验收标准是:修改一个设置、退出、再启动,值还在。损坏场景的验收标准是:把配置文件改成乱码,程序不崩溃,能给出提示,并且原文件被备份成另一个名字。升级场景的验收标准是:旧版本的键能映射到新版本,映射失败时保留旧文件,不覆盖。

这四步里,最容易被省略的是「备份」。很多人觉得配置文件很小,坏了重新生成就行。可配置里往往有用户积累的路径、快捷键、账号偏好,重新生成等于让用户重来一遍。备份的成本只是一个重命名,收益是事故发生时还能捞回来。

版本号字段最好和原子写一起设计:先写临时文件,临时文件里带新版本号,替换成功后再更新内存里的当前版本。这样即使替换失败,旧文件和旧版本号仍然配套,不会出现「文件还是旧的,程序却以为已经迁移过」的状态。迁移函数本身也要可重复执行,失败后重试不应该产生副作用。

出了问题先看哪里

现象真实原因第一步查什么
开发机能保存,用户机器保存失败写到了 exe 目录或 Program Files,普通用户无权限打印实际写入路径;确认是否在用户数据目录
重启后设置回到默认值写到了工作目录,下次启动位置变了对比两次启动时的工作目录与配置路径
配置文件变成半截或空文件直接覆盖写,写入中途进程结束检查是否用了临时文件加重命名
中文目录读不到文件路径被转成字符串再拼回,编码丢失确认全程使用 PathBuf
保存报「拒绝访问」文件只读、被占用,或目录权限受限看错误码与文件属性;换目录复现
升级后旧设置消失新版本不认识旧键,或配置目录变了查版本号与迁移逻辑;对比新旧路径
目录里堆了很多 .tmp 文件写入失败后没有清理临时文件在错误分支加删除;检查重命名失败原因
保存成功了,重启后却变回默认写到了临时目录或非持久位置,被系统清理打印实际路径;确认在用户数据目录而非 Temp 下
两个实例同时保存,配置互相覆盖临时文件名固定,缺少进程级隔离把进程号或随机串拼进临时文件名

边界与代价

文件系统不是数据库,也不是事务系统。原子写能保证「不会出现半截文件」,但保证不了「两次写入的先后顺序符合业务预期」。如果两个进程同时写同一个配置,最后谁赢取决于调度,可能互相覆盖。桌面程序通常假设单实例运行,但用户完全可能双击两次。需要严格互斥时,要用文件锁或单实例机制,而不是指望重命名。

同步盘是另一个变量。把配置放在 OneDrive、Dropbox 同步的目录里,文件可能在写入时被同步进程占用,重命名失败;也可能在另一台机器上被改,产生冲突副本。用户数据目录默认不参与这种同步,这是好事;如果产品需要跨设备同步,应该单独设计同步层,而不是把配置扔进同步盘。

在 Tauri 里,路径不要自己拼,用框架提供的路径解析接口取应用配置目录、缓存目录和日志目录。这样在 Windows、macOS、Linux 上都会落到系统推荐的位置。本机的 Tauri 应用已经构建并启动过(app.exe 8,746 KB,WaitForInputIdle 67 到 68 毫秒),但 fs 插件的路径解析没有实际调用过,这一项仍未验证,所以这一段只是原则,不是实测结论。能确认的是标准库那套原子写在上面跑通了,插件接口落地时应该复用它。

当天能验证的练习

  1. 把 config_fs.rs 里的保存路径改成 exe 所在目录,运行后观察是否失败,理解权限差异。
  2. 在写入临时文件后、重命名之前手动结束进程,检查原文件是否仍然完整。
  3. 给配置文件加一个 version=1 字段,写一段读到版本 1 就补默认键的迁移逻辑。
  4. 把文件名改成包含空格、中文和多个点的形式,确认扩展名解析符合预期。
  5. 把配置文件设成只读,运行程序,记录错误文本,并设计一句用户能看懂的提示。

配置能安全落盘以后,下一个问题是「写入过程会不会卡住界面」。复制一个大目录、导出一个大文件,如果放在命令线程里同步做,窗口就冻住了。下一篇讲后台任务与长耗时操作:线程、通道、进度和取消,以及怎么让界面在重活期间仍然能响应。