readme_cn.md

HashTool

English

HashTool 是一个基于 VB.NET + WPF 开发的轻量级 Windows 桌面文件校验工具，用于计算并校验文件的 MD5 和 SHA256 值，帮助你快速验证文件完整性。

本项目专注于文件校验场景，核心特点是支持多个文件的并行哈希计算，能够在面对大量文件时显著缩短整体校验所需时间。界面简洁、使用直接，适合作为日常工具或 WPF / VB.NET 学习示例。

✨ 功能特性

• 支持 文件哈希校验（不包含文本哈希功能）
• 支持 MD5 / SHA256 算法
• 支持 文件拖拽 操作，直接将文件拖入程序即可开始校验
• 支持 批量文件哈希计算
• 支持 多个文件并行校验，充分利用多核 CPU，在大量文件场景下显著提升哈希计算效率
• 自动根据本机 CPU 核心数匹配并行线程数
• 支持 手动调整线程数量，在性能与资源占用之间灵活取舍
• 支持 校验结果导出，便于保存与后续比对
• 支持 一键复制校验结果，方便快速使用
• 简洁直观的 WPF 图形界面
• 原生 Windows 桌面应用体验
• 项目结构清晰，便于阅读与二次开发

🖼️ 界面预览

🛠️ 技术栈

• 开发语言：VB.NET
• UI 框架：WPF (.NET)
• 界面描述：XAML
• 运行平台：Windows

📂 项目结构

├── MainWindow.xaml              # 主窗口界面
├── MainWindow.xaml.vb           # 主窗口逻辑代码
├── HashToolControl.xaml         # 哈希工具控件界面
├── HashToolControl.xaml.vb      # 哈希工具控件逻辑
├── DwmHelper.vb                 # Windows DWM 辅助类
├── NativeMethods.vb             # Win32 API 封装
└── README.md / README_CN.md     # 项目说明文档

🚀 使用方法

1️⃣ 克隆仓库

git clone https://github.com/luoji12/HashTool.git

2️⃣ 使用 Visual Studio 打开项目

• 推荐使用 Visual Studio 2019 及以上版本
• 确保已安装 .NET 桌面开发相关工作负载

3️⃣ 编译并运行

• 编译解决方案并运行程序
• 通过 文件选择 或 拖拽文件到窗口 的方式添加待校验文件
• 支持一次添加多个文件，程序将自动进行批量处理
• 所有文件的 MD5 / SHA256 将以并行方式计算
• 程序会根据当前电脑 CPU 自动匹配合适的线程数量，也可由用户手动调节
• 在大量文件校验场景下，可显著缩短整体计算时间
• 与官方或期望的哈希值进行对比即可完成校验

📌 运行环境

• Windows 10 / 11
• .NET Framework 或 .NET（以项目配置为准）
• Visual Studio（用于开发）

📖 可扩展方向

如果你希望在此基础上继续完善，可以考虑：

• 增加更多哈希算法（如 SHA1、SHA512）
• 校验结果格式自定义（如 JSON / CSV 扩展）
• 校验结果自动比对与高亮显示
• 深色模式 / 主题切换
• 多语言界面支持

🤝 参与贡献

欢迎任何形式的贡献 🎉

• 提交 Issue 反馈 Bug 或提出新功能建议
• 提交 Pull Request 改进代码或文档

📄 开源协议

本项目采用 MIT License 开源协议，你可以自由使用、修改和分发本项目。

---

如果这个项目对你有帮助，欢迎在 GitHub 上点一个 ⭐ 支持一下！