Rust+Tauri实战：打造Windows内存优化工具RAMGuard Pro

RAMGuard Pro 是一个面向 Windows 的实时内存优化工具，项目标题给出的技术栈组合是 Rust + Tauri。这类工具的核心价值在于，它要在长期驻留、低资源占用、系统 API 调用和前端可视化之间找到平衡点。本文不会只停留在功能描述，而是直接带着一个最小可运行版本走完整个链路：从 Windows 内存模型讲起，搭建 Tauri 2 + Rust 项目，实现内存快照、进程枚举、工作集清理、托盘与开机启动，最后补充常见乱码、权限、invoke 报错和杀软误报的排查路径。读完这篇文章，你可以独立复刻一个与 RAMGuard Pro 同类的 Windows 内存优化器，也能理解为什么“内存优化”不能被简单理解成“让可用内存越高越好”。

1. 内存优化器的真实边界：先理解 Windows 内存模型再动手

1.1 从物理内存到工作集：优化工具到底在优化什么

Windows 的物理内存由内核统一管理，应用程序申请虚拟内存后，内核会在进程真正访问页面时把对应物理页映射进去。一个进程当前正在使用的物理内存页集合，称为工作集（Working Set）。任务管理器里看到的“内存(活动工作集)”，就是这个集合的大小。

内存优化工具最常做的一件事，就是把进程工作集中“暂时不活跃”的物理页面写回页面文件，让这些物理页进入备用列表，从而抬高可用物理内存。这里有两个关键点需要明确。

第一，清理工作集不等于释放进程申请的内存。进程的虚拟内存空间、已提交内存、私有字节数都不会因为清理而减少。如果程序随后继续访问这些页面，Windows 会产生硬错误，把页面从页面文件重新换入物理内存，Cleaner 带来的可用内存收益会迅速回落。第二，Windows 自身也有工作集修剪机制，系统内存压力增大时，内核会主动修剪进程工作集。第三方工具做的事情，本质上是把这个动作提前或扩大。

所以，RAMGuard Pro 这类工具真正应该回答的问题是：能不能在系统响应变慢之前，主动把内存中的冷页换出，而不是等到内存耗尽才被系统强制修剪。基于这个目标，工具需要的核心能力是内存快照、进程枚举、按需清理和可视化反馈，而不是“点击一下可用内存暴涨”的短期效果。

1.2 为什么 RAMGuard Pro 选择 Rust + Tauri

同样是做 Windows 桌面内存优化工具，可选的方案很多，常见组合是 Electron、C# WPF、C++/Qt，以及本文使用的 Rust + Tauri。技术选型的关键矛盾在于：工具本身要长期驻留后台，内存占用必须低到不能成为系统负担，同时又要提供一个可操作、可展示图表和进程表格的界面。

对比起来，几个方案的差异非常明显。

Tauri 比较适合 RAMGuard Pro 的一个原因，是它让后端和系统交互这一层完全掌握在 Rust 手里。Windows API 的 OpenProcess、GetProcessMemoryInfo、EmptyWorkingSet 都可以直接调用，不需要通过桥接层绕路；而窗口、按钮、列表、图表仍然可以用 Web 技术快速搭建。代价也很明确：Rust 编译器对 Windows API 封装版本的差异比较敏感，依赖更新后字段名或方法签名可能变化，需要开发者持续跟进锁定版本。

2. 搭建 Tauri 2 + Rust 项目骨架

2.1 环境准备：Rust、Node.js 和 WebView2 要一起对齐

在 Windows 上运行 Tauri 项目，需要有 Rust stable 工具链、Node.js 和 npm，以及 WebView2 Runtime。Windows 10 和 Windows 11 系统一般自带 WebView2，但如果系统版本较旧，需要单独确认。

打开终端后，先确认工具链版本：

rustc --version cargo --version node --version npm --version

如果 Rust 还没有安装，可以使用 rustup 安装默认 stable 工具链。这里要注意工具链后缀的选择：在 Windows 上，默认推荐 MSVC 工具链，因为后续链接系统库和启用 Windows 长路径都更省心。rustup 配置中如果使用了 GNU 工具链，在调用部分 Windows API 或链接系统库时，可能遇到 ABI 层面的兼容问题，因此学习阶段优先使用x86_64-pc-windows-msvc。

Tauri 2 还需要 Microsoft C++ Build Tools 中的链接器。安装 Visual Studio Build Tools 时勾选“使用 C++ 的桌面开发”工作负载即可。如果本机是刚装好的 Windows，容易漏掉这一项，导致npm run tauri dev第一次编译时在链接阶段报LINK : fatal error LNK1104或找不到link.exe。

2.2 创建项目并理解目录结构

使用官方脚手架创建项目，模板这里选择 vanilla-ts，最小且容易看清结构：

npm create tauri-app@latest ramguard-pro -- --template vanilla-ts cd ramguard-pro npm install

创建完成后，项目目录结构如下：

ramguard-pro/ ├─ src/ │ ├─ main.ts │ └─ styles.css ├─ src-tauri/ │ ├─ src/ │ │ ├─ main.rs │ │ └─ lib.rs │ ├─ Cargo.toml │ ├─ build.rs │ ├─ tauri.conf.json │ ├─ capabilities/default.json │ └─ icons/ ├─ package.json └─ vite.config.ts

这里最容易犯的错是把前端命令和后端命令混在一起。前端部分由 Vite 和 npm 管理，Rust 部分由 Cargo 管理。日常开发运行npm run tauri dev，Tauri CLI 会先启动 Vite 开发服务器，再编译 Rust，最终把一个 WebView 窗口加载到本机地址，同时把前端指向 devUrl。如果直接执行cargo run，会因为没有前端页面而得到一个空白窗口或直接报错。

2.3 配置 Cargo 国内源，避免依赖下载卡住

项目第一次npm run tauri dev时，Cargo 需要拉取大量 crate。如果默认源访问不稳定，最先要做的是配置国内镜像源，而不是等待或重试。在~/.cargo/config.toml中写入：

[source.crates-io] replace-with = "rsproxy-sparse" [source.rsproxy-sparse] registry = "sparse+https://rsproxy.cn/index/"

对于 rustup 工具链更新，可以设置环境变量：

RUSTUP_DIST_SERVER=https://rsproxy.cn RUSTUP_UPDATE_ROOT=https://rsproxy.cn/rustup

npm 依赖下载慢时，也可以切换到 npm 镜像。镜像源只影响下载速度，不影响依赖逻辑，也不需要调整业务代码。这个配置对 Tauri 项目尤其重要，因为 Tauri 2 的依赖树比较大，windowscrate、tauri本体和前端构建链加在一起，首次全量编译等待时间可能很长。

3. 实现系统内存快照与进程枚举

3.1 使用 GlobalMemoryStatusEx 获取系统内存状态

系统内存信息是整个 RAMGuard Pro 前端仪表盘的数据基础。在 Windows 中，最直接的接口是GlobalMemoryStatusEx，它能返回物理内存总量、可用物理内存、页面文件总量、虚拟内存总量等信息。

在src-tauri/src下新增一个memory.rs，先定义对应的 Rust 结构体：

use serde::Serialize; use windows::Win32::System::Memory::{GlobalMemoryStatusEx, MEMORYSTATUSEX}; #[derive(Serialize)] #[serde(rename_all = "camelCase")] pub struct MemoryStatus { pub total_phys: u64, pub avail_phys: u64, pub used_phys: u64, pub total_page_file: u64, pub avail_page_file: u64, pub memory_load: u32, } pub fn get_memory_status() -> MemoryStatus { let mut status = MEMORYSTATUSEX::default(); status.dwLength = std::mem::size_of::<MEMORYSTATUSEX>() as u32; unsafe { GlobalMemoryStatusEx(&mut status).expect("GlobalMemoryStatusEx failed"); } let total_phys = status.ullTotalPhys; let avail_phys = status.ullAvailPhys; MemoryStatus { total_phys, avail_phys, used_phys: total_phys - avail_phys, total_page_file: status.ullTotalPageFile, avail_page_file: status.ullAvailPageFile, memory_load: status.dwMemoryLoad, } }

MEMORYSTATUSEX的关键字段含义如下。

注意，这个函数返回的是瞬时快照。桌面工具显示数字和清理后的效果时，不要指望它是稳定的趋势线，必须配合定时刷新。

3.2 枚举进程列表并读取工作集

内存优化器需要展示所有用户可见进程的内存占用，并允许逐个清理。核心流程是：

1. 调用EnumProcesses获取当前系统所有 PID。
2. 对每个 PID 调用OpenProcess打开进程对象。
3. 调用GetProcessMemoryInfo获取工作集和私有字节数。
4. 调用QueryFullProcessImageNameW获取进程完整路径。
5. 如果OpenProcess因为权限不足失败，跳过该进程并记录原因。

实现代码如下：

use windows::core::PWSTR; use windows::Win32::Foundation::{CloseHandle, HANDLE}; use windows::Win32::System::ProcessStatus::{ EnumProcesses, GetProcessMemoryInfo, PROCESS_MEMORY_COUNTERS, }; use windows::Win32::System::Threading::{ OpenProcess, QueryFullProcessImageNameW, PROCESS_NAME_WIN32, PROCESS_QUERY_LIMITED_INFORMATION, }; #[derive(Serialize, Clone)] #[serde(rename_all = "camelCase")] pub struct ProcessInfo { pub pid: u32, pub name: String, pub path: String, pub working_set: u64, pub private_bytes: u64, } fn read_process_name(handle: HANDLE) -> String { let mut buffer = [0u16; 32768]; let mut size = buffer.len() as u32; let result = unsafe { QueryFullProcessImageNameW( handle, PROCESS_NAME_WIN32, PWSTR(buffer.as_mut_ptr()), &mut size, ) }; if result.is_ok() && size > 0 { String::from_utf16_lossy(&buffer[..size as usize]) } else { String::from("<unknown>") } } pub fn list_processes() -> Vec<ProcessInfo> { let mut pids = [0u32; 4096]; let mut bytes_returned: u32 = 0; unsafe { EnumProcesses( pids.as_mut_ptr(), std::mem::size_of_val(&pids) as u32, &mut bytes_returned, ) .expect("EnumProcesses failed"); } let pid_count = (bytes_returned as usize) / std::mem::size_of::<u32>(); let mut result = Vec::new(); for &pid in pids.iter().take(pid_count) { let process_handle = unsafe { OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, false, pid) }; let Ok(handle) = process_handle else { continue; }; let mut pmc = PROCESS_MEMORY_COUNTERS::default(); let mem_result = unsafe { GetProcessMemoryInfo( handle, &mut pmc, std::mem::size_of::<PROCESS_MEMORY_COUNTERS>() as u32, ) }; let path = read_process_name(handle); unsafe { CloseHandle(handle) }; if mem_result.is_ok() { result.push(ProcessInfo { pid, name: path.rsplit('\\').next().unwrap_or("").to_string(), path, working_set: pmc.WorkingSetSize, private_bytes: pmc.PrivateUsage, }); } } result.sort_by_key(|p| std::cmp::Reverse(p.working_set)); result }

这段代码有几个细节要理解。EnumProcesses返回的是字节数，所以进程数量要用字节数除以u32大小得到。OpenProcess打开的句柄必须通过CloseHandle关闭，否则长时间运行会句柄泄漏。PROCESS_QUERY_LIMITED_INFORMATION是权限最小的查询权限，如果换成PROCESS_QUERY_INFORMATION，很多系统进程会拒绝访问，反而拿不到数据。进程名取完整路径的反斜杠分隔最后一段，中文路径在这个地方最容易出现乱码，后面排错部分会单独讲。

这里使用的 windows crate 版本是 0.58 左右。不同版本的函数签名和结构体字段命名存在差异，如果编译报错，优先查当前版本的windowscrate 文档，而不是机械照抄旧代码。

3.3 把快照数据序列化给前端

为了让前端一次拿到完整数据，把内存状态和进程列表打包成一个快照：

#[derive(Serialize)] #[serde(rename_all = "camelCase")] pub struct MemorySnapshot { pub memory: MemoryStatus, pub processes: Vec<ProcessInfo>, } pub fn collect_snapshot() -> MemorySnapshot { MemorySnapshot { memory: get_memory_status(), processes: list_processes(), } }

在lib.rs中注册命令：

#[tauri::command] fn get_memory_snapshot() -> MemorySnapshot { memory::collect_snapshot() } #[cfg_attr(mobile, tauri::mobile_entry_point)] pub fn run() { tauri::Builder::default() .invoke_handler(tauri::generate_handler![get_memory_snapshot]) .run(tauri::generate_context!()) .expect("error while running tauri application"); }

serde的rename_all = "camelCase"会把total_phys转成前端看到的totalPhys，这样 JavaScript 侧对象风格统一，避免下划线来回转换。

4. 实现工作集清理：EmptyWorkingSet 与权限控制

4.1 EmptyWorkingSet 的原理和限制

清理进程工作集的核心 API 是EmptyWorkingSet，它可以把进程工作集修剪到最小。调用后，进程仍然拥有完整的虚拟地址空间，但其中不活跃的物理页会被写回页面文件，物理内存可用量会立刻上升。

这个 API 的真正意义在于告诉 Windows：当前进程的冷页可以被回收了。它不会抢救已经泄漏的内存，也不改变进程的 Commit Size。最常见的错误理解是“清理后某个程序的内存占用应该变小”，实际上任务管理器里那个程序的工作集可能变小，但提交大小没有变化。

对于 RAMGuard Pro 来说，合理的策略是手动清理、低频自动清理，而不是每秒钟把所有进程的工作集都打空。系统本身有内存管理和缓存机制，过度清理会让进程重新访问内存时产生大量硬错误，反而造成卡顿。

4.2 清理单个进程并返回清理前工作集

清理一个进程需要两个权限：读进程信息和设置进程配额。对应的权限标志是PROCESS_QUERY_LIMITED_INFORMATION | PROCESS_SET_QUOTA。

use windows::Win32::System::Memory::EmptyWorkingSet; use windows::Win32::System::Threading::{PROCESS_QUERY_LIMITED_INFORMATION, PROCESS_SET_QUOTA}; #[tauri::command] fn clean_process_by_pid(pid: u32) -> Result<u64, String> { let handle = unsafe { OpenProcess( PROCESS_QUERY_LIMITED_INFORMATION | PROCESS_SET_QUOTA, false, pid, ) } .map_err(|e| format!("OpenProcess failed, pid={pid}, error={e}"))?; let mut pmc = PROCESS_MEMORY_COUNTERS::default(); unsafe { GetProcessMemoryInfo( handle, &mut pmc, std::mem::size_of::<PROCESS_MEMORY_COUNTERS>() as u32, ) } .map_err(|e| format!("GetProcessMemoryInfo failed, pid={pid}, error={e}"))?; let before = pmc.WorkingSetSize; unsafe { EmptyWorkingSet(handle) } .map_err(|e| format!("EmptyWorkingSet failed, pid={pid}, error={e}"))?; unsafe { CloseHandle(handle) }.ok(); Ok(before) }

命令返回清理前的工作集，前端可以计算出本次清理释放了多少字节。这里计算出来的“释放量”只是工作集减少量，不能把它宣传成“释放了这么多内存”，因为页面换回时又会被重新统计。

4.3 全量清理、进程白名单与系统保护

全量清理就是遍历进程列表，逐个执行上面的清理函数。但有些进程不能碰，直接清理会带来系统不稳定或蓝屏风险。至少需要跳过以下类型：

• PID 为 0 的 System Idle Process。
• PID 为 4 的 System 进程和核心系统进程。
• 当前 RAMGuard Pro 自己，以及它所依赖的 WebView2 子进程。
• 返回错误码 5（拒绝访问）的受保护进程。
• 用户配置到白名单中的进程，例如正在运行的数据库、虚拟机、开发工具等。

全量清理实现：

#[tauri::command] fn clean_all_processes(whitelist: Option<Vec<u32>>) -> Result<CleanResult, String> { let processes = memory::list_processes(); let whitelist = whitelist.unwrap_or_default(); let mut cleaned = 0u32; let mut freed = 0u64; for process in processes { if whitelist.contains(&process.pid) || process.pid <= 4 || process.pid == std::process::id() { continue; } if let Ok(before) = clean_process_by_pid(process.pid) { cleaned += 1; freed += before; } } Ok(CleanResult { cleaned, freed }) }

4.4 管理员权限：没有提权，很多进程根本碰不到

即使代码使用了正确的权限标志，普通权限进程依然无法打开高完整性级别进程。RAMGuard Pro 要看到并清理尽可能多的进程，就需要以管理员权限运行。

在 Tauri 2 项目中，可以通过在src-tauri下添加app.manifest，并在build.rs中嵌入资源：

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0"> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level="requireAdministrator" uiAccess="false" /> </requestedPrivileges> </security> </trustInfo> </assembly>

fn main() { tauri_build::build(); let manifest_path = std::path::PathBuf::from(std::env::var("CARGO_MANIFEST_DIR").unwrap()).join("app.manifest"); println!("cargo:rerun-if-changed={}", manifest_path.display()); embed_resource::compile("app.manifest", embed_resource::NONE); }

对应的Cargo.toml需要添加embed-resource构建依赖。提权是双刃剑，程序如果被注入或利用，影响范围会更大。RAMGuard Pro 属于系统工具，提权可以接受，但必须严格