FileRenamer · 批量重命名工具

一个基于 .NET 8 + WPF 的 Windows 桌面应用，用于对选定的文件 / 文件夹执行批量重命名。支持 9 种预设规则 + 自定义正则，规则可叠加，具备可排序的实时预览和撤销操作。

特性一览

9 种预设重命名规则

所有规则都包含“是否仅修改文件名（不含扩展名）“选项，可以单独控制作用域。

多条规则按列表自上而下的顺序依次应用，可以通过规则列表上方的 ** ** 按钮调整执行顺序。

快速开始

方式一：直接运行已发布的 exe（推荐）

项目已生成两种发布形态，任选其一：

两个版本都已包含 appsettings.json 和日志输出目录 logs/。

方式二：从源码构建并运行

环境要求：

• .NET 8 SDK（Windows x64）
• 可选：Visual Studio 2022 / Rider / VS Code

# 进入解决方案根目录
cd d:\ZS2JZ_NET\ReName\FileRenamer

# 还原并构建
dotnet restore FileRenamer.sln
dotnet build   FileRenamer.sln -c Debug

# 运行应用（或者双击 bin\Debug\net8.0-windows\FileRenamer.exe）
dotnet run --project src/FileRenamer/FileRenamer.csproj

构建 / 发布

运行单元测试

dotnet test tests/FileRenamer.Tests/FileRenamer.Tests.csproj
# 通过! - 失败: 0，通过: 13，已跳过: 0

发布为框架依赖版（小巧）

dotnet publish src/FileRenamer/FileRenamer.csproj `
  -c Release -r win-x64 --self-contained false `
  -p:PublishSingleFile=true -p:DebugType=embedded `
  -o dist/framework-dependent

发布为独立免安装版（自包含 .NET 运行时）

dotnet publish src/FileRenamer/FileRenamer.csproj `
  -c Release -r win-x64 --self-contained true `
  -p:PublishSingleFile=true `
  -p:EnableCompressionInSingleFile=true `
  -p:DebugType=embedded `
  -p:IncludeNativeLibrariesForSelfExtract=true `
  -p:TrimMode=partial `
  -o dist/self-contained

️ 操作说明与快捷键

️ 撤销机制

• 每次” 开始重命名“操作会产生一条历史记录（包含所有受影响文件的原路径和新路径、错误信息、完成时间）
• 历史栈默认 最多保留 50 条（见 appsettings.json Undo.MaxHistoryCount）
• 超过上限时，最旧的记录会被自动丢弃
• 撤销是“回滚每一个文件的重命名”，失败的会被跳过并写入日志
• 可以多次点击“撤销”依次回退，直到历史为空

️ 配置文件（appsettings.json）

{
  "Logging": {
    "LogDirectory": "logs",
    "FileSizeLimitBytes": 5242880,
    "RetainedFileCountLimit": 30
  },
  "Undo": {
    "MaxHistoryCount": 50
  }
}

项目结构

FileRenamer/
 src/
    FileRenamer/                  # 主程序（WPF 应用）
        App.xaml / .cs            # 应用入口：注册资源、日志、异常捕获
        appsettings.json          # 运行时配置
        Assets/AppIcon/           # 应用图标
        Models/
           Enums/RuleType.cs     # RuleType / CaseChangeMode / SequencePosition / DateTimeFormatType
           RenameRule.cs         # 单条重命名规则（所有参数）
           RenameItem.cs         # 列表中的文件/文件夹条目
           RenameHistoryRecord.cs# 撤销历史记录
        Services/
           RenameEngine.cs       # 核心：将规则链应用到文件名
           FileScannerService.cs # 路径扫描（递归子目录、过滤）
           FileRenameService.cs  # 实际执行 IO 重命名 + 错误汇总
           UndoHistoryManager.cs # 撤销历史栈（默认 50 步）
           ShellService.cs       # Shell 集成：打开文件夹、资源管理器高亮
           LogService.cs         # Serilog 日志初始化
        ViewModels/
           MainWindowViewModel.cs # 主窗口 VM：所有命令 / 状态
           RuleEditorTemplateSelector.cs # 根据 RuleType 选对应 DataTemplate
        Views/
           MainWindow.xaml       # 主窗口 UI（工具栏 / 列表 / 规则区 / 状态栏）
           MainWindow.xaml.cs    # 代码隐藏：拖拽、Win32 自绘标题栏钩子等
        Resources/
            EnumResources.xaml    # 枚举下拉源（ObjectDataProvider）
            RuleEditors.xaml      # 9 种规则对应的数据模板 + 共享样式
            ThemeOverrides.xaml   # HandyControl 主题微调

 tests/
    FileRenamer.Tests/
        CoreLogicTests.cs         # 13 条 xUnit 单元测试（13/13 通过）

 dist/
    framework-dependent/          # 框架依赖版发布产物（约 2.3 MB）
    self-contained/               # 独立绿色版发布产物（约 69 MB，免安装）

 Directory.Build.props             # 构建属性（LangVersion / ImplicitUsings 等）
 FileRenamer.sln                   # 解决方案文件
 README.md

单元测试覆盖范围

已通过! - 失败: 0，通过: 13，已跳过: 0

技术栈

️ 日志与故障排查

• 所有操作日志写入程序目录下 logs/log-yyyyMMdd.txt
• 未处理异常由 App.xaml.cs 的 DispatcherUnhandledException 捕获，记录到日志后友好提示
• 单次重命名操作中单个文件失败不会阻断其他文件，失败条目的“新名称”列会变成粉红，鼠标悬停显示错误信息

备注

• 本项目采用 MVVM 分层（Models / ViewModels / Views / Services），便于后续扩展（新增规则只需：在 RuleType 加枚举；RenameRule 加参数属性；RenameEngine 加分支；RuleEditors.xaml 加对应 DataTemplate）
• 默认撤销步数 50、日志保留 30 天（5MB 单文件滚动），可在 appsettings.json 按需调整
• 窗口使用 Win32 DWM 集成自绘标题栏，保留原生阴影、Aero 贴边和边缘缩放