基于 Rust + Tauri 2.0 + Svelte 5 + Vite 的桌面图片浏览器 拖入目录即看 · 字母顺序递归浏览 · 全键盘操作 · 幻灯片播放 · EXIF 查看 · 翻页零动画、极速响应
「极速看图」是一款专注「快速翻看大量本地图片」的桌面应用。把一个文件夹拖进窗口,程序会按字母顺序递归遍历所有子目录,把每个目录里的图片按顺序连成一条完整浏览序列。配合双向预加载技术,左右方向键连按翻页时几乎感觉不到加载延迟;退出时自动记住浏览位置,下次启动从上次那张继续看。
技术栈:
| 层 | 技术 |
|---|---|
| 后端 | Rust 1.77+,Tauri 2,image 库(特殊格式解码),kamadak-exif(EXIF 解析),tauri-plugin-dialog(系统目录选择) |
| 前端 | Svelte 5(runes),Vite 6 |
| 通信 | Tauri IPC 命令 + asset 协议(本地图片零拷贝直显) |
本仓库已在 Debian 13 + Rust 1.98 + Node 24 环境验证:npm run build(前端)、cargo check / cargo test(后端,11/11 单测通过)全部通过;无显示环境,未做 GUI 交互测试,请在目标平台运行 npm run tauri dev 体验。
- 拖拽即开:把文件夹拖到窗口任意位置即可开始浏览;误拖文件时自动打开其所在目录
- 点选即开:引导页大号「+」按钮弹出系统目录选择对话框,与拖拽完全等效(无需鼠标拖拽也能用)
- 一键关目录:
X键关闭当前目录回到引导页,同时清空已记住的位置(下次启动不再自动恢复) - 递归有序浏览:按字母顺序递归遍历所有子目录(自然排序:
img2.jpg排在img10.jpg之前) - 30 余种图片格式:常用格式直显(最快),冷门格式(TIFF/TGA/PNM/DDS/QOI/HDR 等)由 Rust 解码
- 极速翻页:前后双向预加载 + 解码池 + OS 页缓存预热 + PNG 解码缓存,切换零动画纯瞬时
- 智能适配:大图等比缩放至完整可见,小图 1:1 居中黑底显示
- 自由缩放平移:
+/-/滚轮缩放(滚轮以鼠标位置为锚点),放大后可拖拽平移 - 环形循环:最后一张的下一张回到第一张,第一张的上一张回到最后一张
- 目录级跳转:PageUp / PageDown 在「有图的目录」之间跳转(空目录自动跳过)
- 信息栏:Enter 切换显示图片相对路径、已看/总数、宽×高
- 幻灯片播放:空格一键播放/暂停(末尾循环),
,/.分段步长实时调节间隔(0.1~30 秒),播放期间禁止屏保/休眠,信息栏与底部徽标实时显示状态 - EXIF 信息:E 键呼出右侧面板,展示相机/镜头、拍摄时间、快门/光圈/ISO/焦距、测光/曝光程序/白平衡/闪光灯、GPS 位置与文件信息;Rust 侧会话级缓存,开关零成本
- 位置与偏好记忆:退出时记住主目录/子目录/图片,以及幻灯片间隔(未打开目录时调整同样生效)、信息栏/EXIF 面板可见性,下次启动原样恢复
- 全屏 / 最小化:方向键一键切换;最小化时自动退出幻灯片(恢复不自动重启)
| 类别 | 扩展名 | 显示方式 |
|---|---|---|
| 直显格式(WebView 原生渲染,速度最快) | jpg jpeg jpe jfif png apng gif(含动图) bmp dib ico cur webp svg |
asset 协议直接加载 |
解码格式(Rust image 库解码转 PNG) |
tif tiff tga icb vda vst pbm pgm ppm pnm pam dds qoi hdr pic ff(farbfeld) |
解码后缓存为 PNG 再显示 |
| 尽力直显(取决于系统 WebView) | avif jxl heic heif |
WebView 支持则直接显示,否则提示错误 |
说明:AVIF 在 Windows WebView2(Win10/11)通常可直显;HEIC/HEIF 需要系统编解码器支持(macOS 较常见)。不支持时会给出提示,不影响继续浏览。PSD / EXR 等暂不支持。
| 按键 | 功能 |
|---|---|
→ 右方向键 |
下一张图片 |
← 左方向键 |
上一张图片 |
↑ 上方向键 |
全屏显示 / 恢复窗口 |
↓ 下方向键 |
最小化窗口(幻灯片播放时自动退出) |
PageDown |
下一个目录(跳到该目录第一张图) |
PageUp |
上一个目录 |
Home |
第一张图片 |
End |
最后一张图片 |
Esc |
退出程序(帮助层打开时先关闭帮助) |
+ / = |
放大 |
- / _ |
缩小 |
Enter |
显示 / 隐藏图片信息栏 |
E |
显示 / 隐藏 EXIF 信息面板 |
X |
关闭当前目录,回到引导页(同时清除位置记忆) |
空格 |
幻灯片播放 / 暂停(末尾自动循环,播放期间阻止屏保/休眠) |
,(含中文逗号) |
幻灯片间隔减小:≤ 0.5 秒后改 0.1 秒步长(最小 0.1 秒) |
.(含中文句号) |
幻灯片间隔增大:≥ 5 秒后改 1 秒步长(最大 30 秒) |
F1 |
显示 / 隐藏快捷键帮助 |
| 操作 | 功能 |
|---|---|
| 引导页大号「+」按钮 | 点击弹出系统目录选择对话框(与拖拽等效) |
| 点击窗口左半边 | 上一张图片 |
| 点击窗口右半边 | 下一张图片 |
| 滚轮向上 | 放大(以鼠标位置为中心) |
| 滚轮向下 | 缩小 |
| 按住左键拖拽 | 平移图片(放大显示局部时) |
| 拖入文件夹 | 打开 / 切换主目录 |
| EXIF 面板内滚轮 | 滚动查看参数(不触发缩放/翻页) |
信息栏(Enter 切换)显示在窗口顶部:50% 黑色背景 + 白色文字,内容为:
相对主目录的路径/文件名 · 已看张数 / 总张数 · 宽 × 高(px);幻灯片播放中会附加黄色 幻灯片 3.0s 指示。
- 空格 开/关:按当前间隔自动翻到下一张,末尾循环回第一张,跨目录连续播放;手动翻页后重新计时,不打断播放
,/.(支持中文逗号/句号)分段步长调速,范围 0.1~30 秒,播放中立即生效:- 减小:间隔 ≤ 0.5 秒后改用 0.1 秒细步长,最小可到 0.1 秒;其余区间每次 -0.5 秒
- 增大:间隔 < 0.5 秒时每次 +0.1 秒回到 0.5;0.5~5 秒每次 +0.5 秒;≥ 5 秒后改用 1 秒大步长,最大 30 秒
- 播放期间禁止屏保/休眠:跨平台抑制(Windows
SetThreadExecutionState/ macOS IOKit 电源断言 / Linuxsystemd-inhibit),退出幻灯模式即恢复系统默认策略 - 最小化自动退出:窗口最小化(或整窗不可见)时自动退出幻灯模式并解除保活;恢复窗口不会自动重启,需要时再按空格
- 播放中底部显示黄色徽标
幻灯片播放中 · 3.0 秒/张 · 空格暂停,信息栏同步显示间隔 - 间隔随状态文件持久化(未打开目录时调整同样会被记住);下次启动开始幻灯模式时使用上次的间隔值;切换新目录后自动停止(避免误播)
- 复用预加载池:播到的每张图早已解码完毕,节奏稳定不掉帧
右侧半透明面板(避开顶部信息栏),分区展示:
| 分区 | 内容 |
|---|---|
| 文件 | 文件名、相对路径、尺寸、大小、修改时间(任何格式都显示) |
| 相机与拍摄 | 机身+镜头型号、拍摄时间 |
| 曝光参数 | 快门(1/250 s)、光圈(f/2.8)、ISO、焦距、等效 35mm、测光/曝光程序/白平衡/闪光灯 |
| 其他信息 | 拍摄方向、色彩空间、软件、作者、版权、描述 |
| GPS 位置 | 纬度/经度(度分秒 + 十进制)、海拔 |
- 适用 JPEG / TIFF 等含标准 EXIF 的图片;PNG / 截图 / 网络转存图通常没有 EXIF,会显示「不包含 EXIF 数据」及文件信息
- 面板内可滚轮滚动、可选中复制参数;面板上的点击/滚轮不会触发翻页缩放
- 解析在 Rust 侧(
kamadak-exif)阻塞线程池执行,并带会话级缓存
漫画/
├── cover.jpg ← ① 先列出本目录的图片(按文件名自然排序)
├── ch02/
│ ├── 1.jpg ← ③ 再按目录名顺序进入第一个子目录,如此递归
│ └── 10.jpg
├── ch01/ ← ② 注意:ch01 排在 ch02 之后?不 —— 目录按名称排序,
│ └── a.png 所以实际顺序是 ch01 的图先于 ch02 的图
└── empty/ ← 空目录不会出现在 PageUp/PageDown 导航序列里
准确规则:每个目录内,先显示本目录图片(自然排序),再依次进入按名称排序的各子目录递归;文件与目录均忽略大小写、数字按数值比较(img2 < img10,IMG.JPG 与 img.jpg 同级)。目录符号链接不跟随(防目录环)。
| 项 | 要求 |
|---|---|
| Rust | ≥ 1.77.2(安装:https://rustup.rs) |
| Node.js | ≥ 18(推荐 20+) |
| npm | ≥ 9 |
Linux 额外系统依赖(Debian/Ubuntu):
sudo apt-get install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-devWindows:需 WebView2(Win10/11 一般自带)+ MSVC Build Tools(通过 "Desktop development with C++")。
macOS:需 Xcode Command Line Tools(xcode-select --install)。
# 1. 安装依赖
npm install
# 2. 开发模式(热重载)
npm run tauri dev
# 3. 打包发布版(安装包 + 可执行文件)
npm run tauri build打包产物位置:src-tauri/target/release/bundle/(Windows 为 nsis/ 下的安装包与 msi/;macOS 为 dmg/;Linux 为 deb/ rpm/ appimage/)。
若只运行调试版可执行文件:cargo run --manifest-path src-tauri/Cargo.toml(调试构建需要 dev server,正式体验请用 npm run tauri dev 或 npm run tauri build)。
程序在每次切换图片后(防抖 200ms)自动保存位置与界面偏好,并在窗口关闭时兜底保存一次。状态文件:
| 系统 | 路径 |
|---|---|
| Windows | %APPDATA%\jisu-kantu\state.json |
| macOS | ~/Library/Application Support/jisu-kantu/state.json |
| Linux | ~/.config/jisu-kantu/state.json |
删除该文件即可「忘记」上次位置。下次启动时若上次目录已不可用,会回到拖拽引导界面。
按 X 关闭目录与删除状态文件效果相同:立即回到引导页,并把状态文件中的位置清空(幻灯片间隔等界面偏好仍会保留)。之后拖拽或点「+」选择新目录即可开始新的浏览。
状态内容:主目录、子目录、当前图片,以及界面偏好(幻灯片间隔、信息栏 / EXIF 面板可见性)。幻灯片间隔在任何时候调整(包括未打开目录、按 X 之后)都会被记住,下次启动开始幻灯模式时直接使用。v1.0 的旧状态文件可无损升级读取,新字段自动取默认值。
jisu-kantu/
├── index.html # Vite 入口 HTML(内联黑底防白闪)
├── package.json # 前端依赖与脚本(npm run tauri dev/build)
├── vite.config.js # Vite 配置
├── svelte.config.js
├── src/
│ ├── main.js # Svelte 5 mount 入口
│ ├── app.css # 全局样式(黑底、图片元素样式)
│ ├── App.svelte # 主组件:看图核心逻辑(导航/缩放/预加载池/幻灯片/事件)
│ ├── lib/
│ │ └── format.js # 展示格式化工具(快门/光圈/文件大小/日期)
│ └── components/
│ ├── HintScreen.svelte # 引导屏(拖拽提示/大号+按钮/扫描中/空目录/错误)
│ ├── InfoBar.svelte # 顶部信息栏(Enter 切换,含幻灯片指示)
│ ├── ExifPanel.svelte # EXIF 信息面板(E 键切换)
│ └── HelpOverlay.svelte # F1 帮助层
└── src-tauri/
├── Cargo.toml # Rust 依赖(tauri 2 / image 0.25 / kamadak-exif / tauri-plugin-dialog / serde / dirs)
├── build.rs
├── tauri.conf.json # 窗口/asset 协议/打包配置
├── capabilities/default.json # Tauri 2 权限(全屏/最小化/关闭/标题/目录选择对话框)
├── icons/ # 全套图标(png/ico/icns)
└── src/
├── main.rs # 程序入口
├── lib.rs # Tauri Builder 装配(命令注册/事件/退出时解除屏保抑制)
├── scanner.rs # 递归扫描 + 自然排序(含单元测试)
├── decoder.rs # 特殊格式解码 → PNG 缓存(含单元测试)
├── exif.rs # EXIF 解析 + 会话级缓存(含单元测试)
├── state.rs # 状态持久化(含单元测试)
├── power.rs # 幻灯片屏保/休眠抑制(跨平台,含单元测试)
└── commands.rs # Tauri IPC 命令定义
- 零动画直换:切换图片时直接替换 DOM 元素,无过渡、无闪烁(图片先
decode()完成后再上屏) - 双向预加载池:当前图前后各 2~3 张提前创建
<img>并解码,翻到的瞬间位图已就绪 - asset 协议直显:JPG/PNG/GIF/WebP 等由 WebView 直接加载本地文件,无编解码开销
- OS 页缓存预热:
warm_files命令后台预读即将展示的文件 - 解码缓存:特殊格式只在首次解码,结果按「路径+修改时间+大小」哈希缓存为 PNG,二次浏览毫秒级命中
- 池自动回收:远离当前位置的缓存图片及时释放,内存占用稳定
- EXIF 惰性加载:只在面板可见时拉取,Rust 侧会话级缓存 + 阻塞线程池解析,不影响翻页速度
Q:为什么我的照片没有 EXIF? PNG / 截图 / 微信转存图等通常不含 EXIF;另外 HEIC 在部分平台的 WebView 不支持,EXIF 也读不到。JPEG / TIFF 照片一般都有。
Q:幻灯片会不会播到一半卡住? 不会。播放复用预加载池,下一张总是提前解码好;遇到无法解码的图会照常跳过继续。
Q:HEIC(iPhone 照片)显示不了? HEIC 需要系统 WebView 支持。Windows 需安装「HEIF 图像扩展」;部分 Linux WebKitGTK 版本不支持。程序会提示错误并可继续翻页。
Q:想改成「目录在前、文件在后」或其他排序?
修改 src-tauri/src/scanner.rs 中 scan_dir 的 files / subdirs 处理顺序即可,逻辑集中在一处。
Q:为什么我打不了正式包?
确认系统依赖完整(见「环境要求」),首次 npm run tauri build 会下载打包工具(NSIS / linuxdeploy 等),需要网络。
Q:图片切换为什么完全看不到加载过程? 这就是设计目标:图片在后台预解码完成后才瞬时上屏。网络盘上特别大的图首次仍可能有极短等待。
Q:点「+」选了目录没反应?
对话框中必须选中一个文件夹并确认;取消选择不会做任何事。若对话框都无法弹出,请检查 tauri-plugin-dialog 是否已随项目编译(正常 npm install + cargo build 会自动处理)。
本项目代码供学习与自由使用。