一个做素材管理的小组有个内部工具:扫描指定目录,读出文件名和大小,按规则批量改名,最后导出一份清单。原型是别人用前端技术套了个桌面壳做的,三天就出了能演示的版本。可真正发到组里那批旧笔记本上,问题全来了:安装包两百多兆,双击以后要等两三秒才看见界面,偶尔还会白屏。
他们听说 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 写。外壳可以是系统自带的 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 的版本号则是运行时查注册表得到的,两者不要混在一起看。
一个能跑的核心:重命名计划
选外壳之前,先把核心逻辑用纯 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 很快」有用。
当天能验证的练习
- 把
webview2_check.rs编译运行,记下你机器上的 WebView2 版本;再找一个 HKCU 有安装的机器对比输出差异。 - 改
rename_plan.rs,让它跳过已经是目标格式的文件,重复运行两次,确认第二次没有生成新名字。 - 在重命名计划里加入「目标文件已存在」的检查,输出冲突列表而不是直接覆盖。
- 把目录换成你自己的一个真实文件夹(先复制一份),看排序结果是否符合预期,特别是中文名和大小写混合的情况。
- 用
cargo new建一个空工程,把上面的核心逻辑挪进去,对比cargo run和rustc直接编译的体验差异。 - 用
rustc -vV和cargo -V记录本机工具链,再确认 MSVC 链接器能被找到;这一步决定你后面的构建能不能走出编译阶段。
做完这几步,你已经有了一个能独立验证的核心,也知道了自己机器上的运行时状况。接下来要解决的是「界面从哪来」。下一篇从 Tauri 入手,把一个空窗口跑起来,看清楚前端、Rust 侧和配置文件各自负责什么,再决定这条路适不适合你的项目。