FreeReNamer批量重命名工具本地开发与部署完整指南从pnpm dev到打包三端客户端【免费下载链接】FreeReNamer功能强大又易用的文件批量重命名软件项目地址: https://gitcode.com/gh_mirrors/fr/FreeReNamerFreeReNamer是一款功能强大又易用的文件批量重命名软件同时提供网页版与 Tauri 桌面客户端两种形态。这篇文章带你完成 FreeReNamer 的本地开发与部署全流程用pnpm dev三步跑起网页版、用pnpm tauri dev调试桌面客户端最终打包出 Windows / macOS / Linux 三端安装包新手也能直接照做 ✅项目一览Web Tauri 双端架构FreeReNamer 采用一套前端代码、双平台运行的架构通过PLATFORM环境变量区分构建目标由 Vite 在编译期注入全局常量运行时自动选择对应的文件操作实现技术作用React 18 TypeScript Vite前端界面与构建Tauri 1.x Rust桌面客户端原生能力TanStack Router / Query路由与异步数据Jotai shadcn/ui状态管理与 UI 组件核心目录速查src/components/界面组件文件面板、规则编辑、设置等src/lib/rules/批量重命名规则引擎替换、删除、格式化、模板、脚本、AI 等src/lib/file/平台无关的文件操作封装file.web.ts走浏览器 APIfile.tauri.ts走 Rust 原生命令src-tauri/Rust 后端核心命令在src-tauri/src/main.rssrc-tauri/tauri.conf.json窗口、权限与打包配置环境准备安装 Node.js、pnpm 与 Rust 工具链 只玩网页版可以跳过 Rust要打包桌面客户端则两者都要装。依赖用途要求Node.js前端运行环境18 及以上版本pnpm依赖包管理8 及以上版本Rustrustup桌面客户端编译stable 版本平台构建工具原生编译Windows 需 Visual Studio Build ToolsLinux 需 webkit2gtk 等 WebView 依赖安装完成后用node -v、pnpm -v、rustc -v三个命令确认版本均正常输出即可。pnpm dev 三步跑起网页版第 1 步获取源码git clone https://gitcode.com/gh_mirrors/fr/FreeReNamer cd FreeReNamer第 2 步安装依赖pnpm install第 3 步启动开发服务器pnpm dev脚本实际执行的是cross-env PLATFORMweb vite浏览器打开http://localhost:1420即可看到 FreeReNamer 批量重命名界面改代码即时热更新。开发端口 1420 在vite.config.ts中配置为strictPort若提示端口被占用释放掉再启动即可。网页版运行效果如下左侧添加文件与文件夹右侧编排处理规则执行前会实时预览新文件名 网页版小提示文件操作基于浏览器 FileSystemHandle API建议使用最新版 Chrome配置数据存储在 IndexedDB 中而桌面端则存储在本地文件。桌面客户端本地调试pnpm tauri dev装好 Rust 后一条命令即可启动 Tauri 桌面端热调试pnpm tauri dev它会先通过beforeDevCommand自动运行pnpm dev-in-tauri即PLATFORMtauri vite再拉起原生窗口前端与 Rust 两侧改动都能即时生效。Rust 侧在src-tauri/src/main.rs中暴露了rename、read_dir、is_file等 Tauri 命令前端通过src/lib/file/file.tauri.ts调用这些命令完成真正的重命名性能与兼容性都优于网页版。生产构建打包 Windows / macOS / Linux 客户端打包网页版产物在dist/可部署到任意静态服务器pnpm build打包桌面客户端pnpm tauri buildtauri.conf.json中bundle.targets已设为all在哪个系统上执行命令就产出对应平台的安装包跨平台打包需要目标系统或交叉编译环境平台常见产物WindowsNSIS 安装程序.exemacOS.dmg / .appLinux.deb / .AppImage 等打包完成的安装包位于src-tauri/target/release/bundle/目录下应用标识为com.cyhuajuan.free-renamer。常见问题快速排查清单端口 1420 被占用strictPort模式下 Vite 不会自动换端口杀掉占用进程后重启。pnpm tauri dev报找不到 rustc未安装 Rust 工具链按上文用 rustup 安装后重开终端。Linux 启动白屏/报错缺少 WebView 依赖如 webkit2gtk安装发行版对应开发包即可。代码风格检查提交前运行pnpm lint基于 Biome确保通过。关键文件路径总结文件说明package.jsondev / build / tauri 等脚本入口vite.config.ts1420 端口与 PLATFORM 注入配置src/lib/rules/index.ts所有重命名规则的注册入口src/lib/file/file.web.ts网页版文件操作实现src/lib/file/file.tauri.ts桌面端文件操作实现src-tauri/src/main.rsRust 命令与 Tauri 应用入口src-tauri/tauri.conf.json窗口权限与打包配置总结 到这里你已经完整走通了 FreeReNamer 的本地开发与部署pnpm dev启动网页版、pnpm tauri dev调试桌面端、pnpm tauri build打包出 Windows / macOS / Linux 客户端。得益于 Web Tauri 双端架构一套代码即可覆盖浏览器与桌面场景非常适合想在本地体验或二次开发批量重命名工具的同学上手。【免费下载链接】FreeReNamer功能强大又易用的文件批量重命名软件项目地址: https://gitcode.com/gh_mirrors/fr/FreeReNamer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考