一个做素材管理的小组有个内部工具:扫描指定目录,读出文件名和大小,按规则批量改名,最后导出一份清单。原型是别人用前端技术套了个桌面壳做的,三天就出了能演示的版本。可真正发到组里那批旧笔记本上,问题全来了:安装包两百多兆,双击以后要等两三秒才看见界面,偶尔还会白屏。

他们听说 Rust 编出来的程序又小又快,于是来问:能不能用 Rust 把这个工具重写一遍?这个问题听起来简单,实际上要拆成两半。第一半是「计算和文件操作能不能用 Rust 写」,答案是可以,而且很合适。第二半是「窗口和控件谁来画」,Rust 本身不提供界面,你得选一个外壳。很多人第一次接触 Rust 桌面,就是卡在第二半上:以为换个语言就能自动得到更轻的界面,结果发现只是把外壳换了个位置。

这篇先把「Rust 做桌面」这件事的真实结构讲清楚:桌面程序分成哪几层、市面上三条路线各自在做什么、你该按什么顺序做决定。后面七篇再分别深入 Tauri、原生窗口、通信、文件、后台任务、更新和打包。本文按 stable Rust 1.99 讲解,Windows 相关操作在 Windows 11 上验证,跨平台差异会单独点出来,不把 Windows 的做法当成通用结论。

把这台机器的工具链报一遍,方便你对照:rustc 1.99.0,cargo 1.99.0,MSVC 19.51,系统是 Windows 11。Rust 用的是 MSVC 目标,链接器来自 Visual Studio Build Tools;这三样缺一个,cargo build 就会停在链接阶段,而不是编译阶段。安装时没有用管理员权限,所以路径都落在用户目录下,这一点在后面打包和权限两篇里还会提到。

先分清:Rust 不是 GUI 框架

把桌面程序拆开看,至少有三层。最上面是使用者看见的东西:窗口、按钮、列表、输入框。中间是把界面动作翻译成程序命令的桥:点了「开始扫描」,要把目录路径传下去;扫描进度回来了,要显示在进度条上。最下面是真正干活的逻辑:遍历目录、读文件、算新名字、写结果。Rust 天生擅长的是最下面这层和中间那层的后半段,最上面那层它不管。

界面层:窗口、控件、滚动、焦点,由你选的外壳负责
桥接层:命令调用、事件回传、状态共享,由外壳框架和你的代码共同负责
核心层:文件、计算、网络、数据库,由 Rust 负责,也是最能体现语言优势的地方

所以「用 Rust 做桌面」更准确的说法是:用一个 Rust 能接入的界面外壳,把核心逻辑用 Rust 写。外壳可以是系统自带的 WebView,也可以是一个直接画像素的窗口库。两种选择的差别,比「用不用 Rust」大得多。

这也解释了一个常见误会:有人把 Rust 重写当成性能银弹,结果界面还是那套网页,启动还是要初始化浏览器内核,体积也没降多少。真正变快的是扫描、解析、压缩这些计算密集的部分;如果瓶颈本来就在界面框架的初始化上,换语言解决不了。

三条现实路线

目前能落地的路线大致三条,先把它们摆在一起,再谈细节。

WebView 外壳

代表是 Tauri 2。窗口、菜单、托盘由 Rust 侧创建,界面内容仍然是 HTML、CSS、JavaScript,跑在系统 WebView 里。优点是前端生态直接复用,界面改起来快,安装包通常比自带浏览器的方案小一个数量级;代价是你仍然要写前端,而且要先确认目标机器上的 WebView 运行时存在。

原生窗口与自绘

代表是 winit 加 egui、iced、slint 这类库。窗口、事件循环、绘制都在进程内完成,不依赖浏览器内核。优点是启动快、体积可控、对系统资源占用低;代价是控件生态比 Qt 弱,复杂表格、富文本、无障碍支持要自己补,跨平台外观也要自己处理。

第三条是混合路线:外壳还是 Tauri 或原生窗口,但把某一块能力做成独立进程或系统插件,比如调用系统的文件预览、接一个本地服务、嵌入一个专门做图表的原生控件。这条路在真实项目里很常见,因为没有一个方案能同时满足所有需求。你不必一开始就选边站,先确定「哪一块必须原生」,剩下的再交给外壳。

选择顺序建议是这样的:先看目标机器和分发方式,再看界面复杂度,最后才看语言偏好。如果工具只在公司内部几十台 Windows 电脑上用,WebView 外壳几乎总是更省时间;如果要发给不确定的外部用户、安装包大小敏感、或者界面本身就是大量自绘图表,原生窗口更稳。

回到开头那个素材工具,三条路线分别意味着什么?走 WebView 外壳,扫描和改名的逻辑仍然用 Rust 写,界面沿用他们已经熟悉的前端,主要工作变成把 IPC 和文件权限接对;走原生窗口,界面要重写,但启动和体积能压下来,代价是列表、表格、右键菜单这些控件得自己补;走混合路线,可以保留网页界面,只把「批量改名」做成一个独立的 Rust 进程,界面通过本地端口或标准输入输出调它。对三五个人维护的内部工具,第三条往往最省事,因为它不要求一次换掉全部。

体积这件事最好用实测数字说话。本机用 cargo new 建了一个最小 winit 工程,release 产物 exe 是 519.5 KB;同样是最小窗口,换成 eframe 0.32.3 加一个滑块和一个按钮,产物变成 4972 KB。前者只负责开窗,后者自带界面库、文字排版和图形后端。所以「Rust 桌面很小」这句话要加限定:只创建窗口时确实小,带界面库之后就进入几兆的量级。

先做环境自检:WebView2 在不在

如果倾向 Tauri,第一件要确认的不是 Rust 版本,而是目标机器上有没有 WebView2 运行时。Windows 11 一般自带,Windows 10 不一定,精简版系统和企业镜像里被裁掉的情况都遇到过。判断方法很直接:查注册表里的客户端版本号。下面这个程序只用了标准库,通过调用系统自带的 reg 命令来查询,不需要任何第三方 crate,因此可以直接用 rustc 编译。

use std::process::Command;

const KEYS: [(&str, &str); 2] = [
    (
        "HKLM",
        r"SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}",
    ),
    (
        "HKCU",
        r"Software\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}",
    ),
];

fn query(root: &str, key: &str) -> Option<String> {
    let out = Command::new("reg")
        .args(["query", &format!(r"{}\{}", root, key), "/v", "pv"])
        .output()
        .ok()?;
    if !out.status.success() {
        return None;
    }
    let text = String::from_utf8_lossy(&out.stdout);
    text.lines()
        .find(|line| line.contains("REG_SZ"))
        .and_then(|line| line.split("REG_SZ").nth(1))
        .map(|value| value.trim().to_string())
}

fn main() {
    for (root, key) in KEYS {
        match query(root, key) {
            Some(version) => println!("[webview2] {} -> {}", root, version),
            None => println!("[webview2] {} -> not found", root),
        }
    }
    println!(
        "[host] os={} arch={}",
        std::env::consts::OS,
        std::env::consts::ARCH
    );
}

编译和运行命令如下,结果直接来自本机:

rustc -O webview2_check.rs
.\webview2_check.exe
[webview2] HKLM -> 156.0.4314.58
[webview2] HKCU -> not found
[host] os=windows arch=x86_64

输出说明这台机器在系统级(HKLM)装了 WebView2,版本 156.0.4314.58;当前用户级(HKCU)没有单独安装。两个位置查一个就行,系统级有就够用。如果两个都返回 not found,Tauri 程序启动时会直接报错或白屏,这时要么让安装包带上 WebView2 引导程序,要么在启动前给出明确提示,而不是让用户对着一片空白猜。

这段输出里还有一行 [host] os=windows arch=x86_64,它是编译期常量,不查系统。把它打出来是为了让日志能区分「在谁的机器上跑的」,排查跨平台问题时很有用。WebView2 的版本号则是运行时查注册表得到的,两者不要混在一起看。

WebView2 是 Windows 的概念。macOS 用的是系统自带的 WKWebView,不需要单独安装;Linux 通常依赖 WebKitGTK,而且不同发行版的版本差异很大,很多「Windows 上好好的,Linux 上起不来」的问题就出在这里。写跨平台文档时,别把「检查 WebView2」写成通用步骤。

一个能跑的核心:重命名计划

选外壳之前,先把核心逻辑用纯 Rust 跑通,这一步能帮你判断「Rust 到底适不适合这个工具」,而且不需要任何界面依赖。下面这段程序扫描目录、按文件名排序、生成新的编号名,完整可编译:

use std::fs;
use std::path::{Path, PathBuf};

fn plan(dir: &Path, prefix: &str) -> std::io::Result<Vec<(String, String)>> {
    let mut files: Vec<PathBuf> = fs::read_dir(dir)?
        .filter_map(|entry| entry.ok())
        .map(|entry| entry.path())
        .filter(|path| path.is_file())
        .collect();
    files.sort();

    let mut result = Vec::new();
    for (index, path) in files.iter().enumerate() {
        let old = path.file_name().unwrap().to_string_lossy().to_string();
        let ext = path
            .extension()
            .map(|e| e.to_string_lossy().to_string())
            .unwrap_or_default();
        let new = if ext.is_empty() {
            format!("{}_{:03}", prefix, index + 1)
        } else {
            format!("{}_{:03}.{}", prefix, index + 1, ext)
        };
        result.push((old, new));
    }
    Ok(result)
}

fn main() -> std::io::Result<()> {
    let dir = std::env::temp_dir().join("rename-demo");
    let _ = fs::remove_dir_all(&dir);
    fs::create_dir_all(&dir)?;
    for name in ["b 副本.txt", "a.jpg", "说明", "c.PNG"] {
        fs::write(dir.join(name), b"x")?;
    }

    println!("[dir] {}", dir.display());
    for (old, new) in plan(&dir, "素材")? {
        println!("[plan] {:>12} -> {}", old, new);
    }
    Ok(())
}
rustc -O rename_plan.rs
.\rename_plan.exe
[dir] C:\Users\c1805\AppData\Local\Temp\rename-demo
[plan]        a.jpg -> 素材_001.jpg
[plan]     b 副本.txt -> 素材_002.txt
[plan]        c.PNG -> 素材_003.PNG
[plan]           说明 -> 素材_004

这段输出里有几个值得注意的细节。中文文件名没有乱码,因为 Rust 的 Path 在 Windows 上按宽字符处理,to_string_lossy 只是在显示时转成字符串;扩展名保留原样,所以 .PNG 不会变成 .png;没有扩展名的「说明」也能生成新名字。真正上线时还要处理重名冲突、只改一部分文件、以及「改名失败要不要回滚」,这些都属于核心逻辑,和界面无关,先在这里测透最省事。

排序规则也值得提前定死。示例是按完整文件名排序,所以 a.jpg 在 b 副本.txt 前面,c.PNG 在 说明 前面;一旦用户期望「按修改时间」或「按数字序号」排,生成的新名字就会整体错位。把排序键做成一个显式参数,并在界面上显示「当前按什么排」,比事后解释「为什么编号和你想的不一样」便宜得多。这个决定不需要框架,纯 Rust 就能验证。

顺便说一句,这段程序用 rustc 直接编译就够了,不需要 Cargo。等到引入第三方库时再建 Cargo 工程;一开始就把依赖降到零,能让你更快确认问题到底出在语言、系统还是界面上。

从需求到跑起来:一次完整走查

把上面的片段拼成一次真实的开发顺序,大概是五步。注意每一步都有明确的验收标准,不是「写完就算」。

一个小工具从需求到可分发
先把核心逻辑用命令行跑通
按目标机器选外壳并做环境自检
接上界面,用一个真实目录走完整流程
在干净机器上打包试装
补错误提示与升级路径

第一步的验收标准是:给一个包含中文名、空格、大小写混合扩展名的目录,输出的新名字符合规则,并且能在只读文件、被占用文件上给出可读的错误。第二步的验收标准是:在目标系统版本上确认 WebView 运行时存在,或者确认原生窗口库能正常创建窗口。第三步的验收标准是:点一次按钮,界面不卡,进度能看到,取消能生效。第四步的验收标准是:把安装包拿到一台没装开发工具的机器上,双击能起来,资源能找到。第五步的验收标准是:旧版本的用户配置能升级,升级失败能退回。

这个顺序的好处是每一步都能独立验证。最常见的翻车方式是反过来:先花两周搭界面,最后发现目标机器缺运行时,或者核心逻辑在真实数据上根本跑不通,前面搭的东西全要返工。

第一步的环境准备有个容易忽略的点:Rust 的 MSVC 目标和 C++ 构建工具是两套东西。只装 rustup 能编译纯 Rust 代码,但一旦链接系统库,或引入需要本地编译的 crate,就会要求 MSVC 链接器。本机的 MSVC 19.51 是单独装的 Build Tools,没有装完整 Visual Studio;对 Rust 桌面来说已经够用。这个区别在第一次构建失败时最能体现:报错会指向链接器,而不是 Rust 语法。

出了问题先看哪里

桌面程序的问题往往表现为「界面上一个奇怪的现象」,但根因可能在三层中的任何一层。下面这张表是这一组文章会反复用到的排查顺序,先按现象定位层,再往下查。

现象真实原因第一步查什么
双击后白屏或直接退出WebView2 运行时缺失,或前端资源没打进包查注册表 pv 值;把安装包解开看资源目录
点按钮后界面卡住不动耗时任务跑在界面线程上,阻塞了事件循环看任务是不是同步调用;加日志打时间戳
进度条走到一半停住后台线程结束了但没发最后一条事件,或事件被丢弃在任务结束处打日志;检查事件通道是否还有接收方
中文路径读不到文件路径被当成字节串拼接,或工作目录和预期不一致打印绝对路径;确认用的是 PathBuf 而不是字符串相加
开发机能跑,别人机器报缺 DLL依赖了本机安装的运行时或动态库在干净虚拟机上试装;看错误里的模块名
升级后用户设置全丢配置目录换了位置,或新版本读不懂旧格式对比新旧配置路径;查有没有版本迁移代码
程序关了进程还在后台线程或子进程没有随主窗口退出任务管理器看残留进程;检查线程 join 与子进程 kill

边界与代价

Rust 桌面不是没有代价的,只是代价换了个地方。第一是学习曲线:所有权、生命周期、Send 与 Sync 这些概念,在写小脚本时感觉不到,一旦要在界面线程和后台线程之间共享状态,就会集中出现。第二是生态成熟度:Tauri 2 已经能支撑正经产品,但插件质量参差;原生 GUI 库的版本迭代快,API 变动大,网上搜到的示例可能对应旧版本。第三是跨平台细节:窗口装饰、菜单栏、托盘、文件对话框、DPI 缩放,各平台行为不同,真正的「一次编写到处运行」在桌面端从来都是打折的。

还有一条容易被忽略:Rust 保证内存安全,但不保证逻辑正确。文件被覆盖、配置写坏、更新装反,这些都不是编译器能拦住的。桌面程序直接操作用户的数据和磁盘,出错成本比网页高,所以这一组文章会反复强调原子写、备份、回滚这些「不酷但救命」的细节。

再说体积和启动。本机的 Tauri 应用编译产物是 8,746 KB,启动到窗口可交互 67 到 68 毫秒,工作集 25.1 MB;winit 空窗口 519.5 KB;eframe 带控件 4972 KB。三组数字对应三种取舍,不是同一个东西的三种写法。选型时把这三个量级记住,比记「Rust 很快」有用。

如果你的工具只需要一个人用、只在一台机器上跑,别急着上框架。一个纯 Rust 的命令行程序加一个最简单的窗口,可能比完整框架更快做完,也更容易排查。选型是为了解决问题,不是为了用上某个技术。

当天能验证的练习

  1. 把 webview2_check.rs 编译运行,记下你机器上的 WebView2 版本;再找一个 HKCU 有安装的机器对比输出差异。
  2. 改 rename_plan.rs,让它跳过已经是目标格式的文件,重复运行两次,确认第二次没有生成新名字。
  3. 在重命名计划里加入「目标文件已存在」的检查,输出冲突列表而不是直接覆盖。
  4. 把目录换成你自己的一个真实文件夹(先复制一份),看排序结果是否符合预期,特别是中文名和大小写混合的情况。
  5. 用 cargo new 建一个空工程,把上面的核心逻辑挪进去,对比 cargo run 和 rustc 直接编译的体验差异。
  6. 用 rustc -vV 和 cargo -V 记录本机工具链,再确认 MSVC 链接器能被找到;这一步决定你后面的构建能不能走出编译阶段。

做完这几步,你已经有了一个能独立验证的核心,也知道了自己机器上的运行时状况。接下来要解决的是「界面从哪来」。下一篇从 Tauri 入手,把一个空窗口跑起来,看清楚前端、Rust 侧和配置文件各自负责什么,再决定这条路适不适合你的项目。