SHA256是校验文件完整性的最稳妥选择,需流式读取、标准化哈希字符串并安全存储参考值。

用 SHA256 计算文件哈希是最稳妥的选择
校验文件完整性,本质是确认文件内容没被篡改或损坏。C# 中最常用、也最推荐的方式是用 SHA256(或 SHA512)计算整个文件的哈希值——它抗碰撞强、.NET 原生支持、性能足够好。别用 MD5 或 SHA1,它们已被证实不安全,尤其在需要防恶意篡改的场景下。
关键点在于:必须流式读取(FileStream + HashAlgorithm.ComputeHash(Stream)),不能先把整个文件加载进内存(File.ReadAllBytes),否则大文件(比如几个 GB 的安装包)会直接 OOM。
-
SHA256.Create()返回的是可重用实例,但每次调用ComputeHash前无需手动Initialize(),框架已处理 - 结果是字节数组,通常转成十六进制字符串存储或比对:
BitConverter.ToString(hash).Replace("-", "").ToLowerInvariant() - 注意编码无关性:哈希只依赖字节流,和文本编码、BOM、换行符完全无关
校验时对比哈希值要忽略大小写和分隔符
你拿到的参考哈希(比如从官网下载页贴出来的 SHA256 值),常常带空格、短横线,或者全大写。而 BitConverter.ToString() 默认带短横、大写。直接字符串 == 会失败。
实操建议统一标准化再比对:
- 把参考哈希先清理:去掉所有非十六进制字符(
Regex.Replace(input, "[^a-fA-F0-9]", "")),再转小写 - 把计算出的哈希也做同样处理:
BitConverter.ToString(hash).Replace("-", "").ToLowerInvariant() - 最后用
string.Equals(a, b, StringComparison.Ordinal)比较,不用==防意外
错误现象举例:"A1B2-C3D4" 和 "a1b2c3d4" 看似一样,但直接 == 返回 false;不清理短横也会导致长度不等。
完整校验逻辑封装成方法,避免重复打开文件
一个健壮的校验函数应该:接受文件路径和预期哈希(清理后的)、返回布尔值、内部处理异常、且只打开文件一次。别写成“先算哈希 → 再开一次文件比对”这种低效又易错的模式。
public static bool VerifyFileHash(string filePath, string expectedHash) {
if (!File.Exists(filePath)) return false;
try {
using var fs = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read, 8192, FileOptions.SequentialScan);
using var sha256 = SHA256.Create();
var hashBytes = sha256.ComputeHash(fs);
var actualHash = BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();
return string.Equals(actualHash, expectedHash, StringComparison.Ordinal);
}
catch (IOException) {
return false; // 文件被占用、权限不足等
}
catch (UnauthorizedAccessException) {
return false;
}
}
注意 FileOptions.SequentialScan 能提升大文件读取性能;缓冲区设为 8192 是经验值,比默认 4096 更稳;异常捕获范围只限 IO 类,不吞掉 OutOfMemoryException 这类严重问题。
项目中如何存和用参考哈希才不容易出错
别把哈希硬编码在 C# 源码里,也别存在没校验的 JSON/INI 中。最简单的生产就绪做法是:把哈希值单独存成一个同名 .sha256 文件(如 app.zip.sha256),内容就是纯哈希字符串(无空格、无换行、小写)。
- 生成时:用命令行
certutil -hashfile app.zip SHA256或 PowerShellGet-FileHash app.zip -Algorithm SHA256 | % Hash,复制结果手动保存,或脚本自动生成 - 校验时:先读
filePath + ".sha256",用上面的VerifyFileHash方法校验,失败就报“哈希文件缺失或不匹配” - 风险提示:如果哈希文件和原文件放同一服务器,被黑后可能一起被篡改——这时需通过 HTTPS 单独下载哈希,或用数字签名验证哈希文件本身
真正容易被忽略的不是算法怎么写,而是哈希源是否可信、传输过程是否被劫持。代码再严谨,参考值错了,一切归零。










