应使用 MD5.Create() 而非已过时的 MD5CryptoServiceProvider；用 File.OpenRead() 流式计算大文件哈希，避免内存溢出；注意路径合法性、权限问题及哈希字符串格式统一（小写无横线），推荐迁移到 HashAlgorithm.Create(HashAlgorithmName.MD5) 以提升可维护性。
用
计算文件哈希最稳
别碰
—— 它是旧版 .NET Framework 的遗留类型，.NET Core / .NET 5+ 中已标记为过时，且在某些 AOT 或容器环境下可能抛
。直接用静态工厂
，它会自动返回当前运行时支持的最优实现。
常见错误是手动 new 一个具体类，或者误以为要传参数进去。其实就一行初始化：
比
更安全：大文件（比如几百 MB 的安装包）不会一次性占满内存
别用
去“读文件内容再算哈希”——那是算文本哈希，不是文件二进制哈希
注意
默认带短横线，校验时若服务端给的是无分隔符小写字符串，必须
校验安装包时，路径和权限最容易翻车
你本地跑通了，一放到客户机器上就报
或
，大概率不是算法问题，而是执行上下文没搞清。
C知道
CSDN推出的一款AI技术问答工具
下载
如果是 Windows 服务或后台进程启动的安装程序，
可能指向 system32 或服务 bin 目录，不是你期望的安装包所在路径
用绝对路径前先确认：调用
，再检查
，别假设路径一定存在
安装包常被下载到
，而某些杀软或组策略会限制对临时目录的读取——建议提前用
包住流打开逻辑，并给出明确提示（比如“无法读取安装包，请关闭杀毒软件重试”）
比对哈希值时，大小写和格式必须严格一致
MD5 值本质是 16 字节二进制，转成字符串只是表现形式。服务端给的参考值可能是大写、带短横、甚至带
前缀；你本地算出来的小写无分隔符，直接
会失败。
统一转成小写 + 去短横是最简方案，但前提是双方约定好这个规范
更健壮的做法是把字符串先解析回字节数组再比：
，避免任何字符串处理引入歧义
如果参考值来自 HTTP Header（如
），注意它可能被代理截断或编码，建议优先走 JSON body 或独立校验文件传输
.NET 6+ 推荐用
+
API
虽然
还能用，但新项目建议迁移到
配合泛型哈希入口，语义更清晰，也预留了未来切 SHA256 的余地。
是枚举值，比字符串字面量更类型安全
注意
返回的是
抽象类实例，不是具体实现类，不用管底层是哪套 provider
如果将来要升级到 SHA256，只需改一个枚举值，其余代码完全不动
实际部署时，最常被忽略的是：校验逻辑没进重试或 fallback。比如网络下载中断后补了个不完整文件，MD5 必然不匹配，但程序直接报错退出，而不是提示“校验失败，是否重新下载？”。这种交互细节，比哈希算法本身更容易让用户放弃安装。
MD5.Create()MD5CryptoServiceProviderPlatformNotSupportedExceptionMD5.Create()using (var md5 = MD5.Create())
{
using (var stream = File.OpenRead(filePath))
{
var hashBytes = md5.ComputeHash(stream);
return BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();
}
}File.OpenRead()File.ReadAllBytes()Encoding.UTF8.GetBytes()BitConverter.ToString().Replace("-", "").ToLowerInvariant()UnauthorizedAccessExceptionFileNotFoundExceptionAppDomain.CurrentDomain.BaseDirectoryPath.GetFullPath(filePath)File.Exists()%TEMP%try/catch (IOException)0x==Enumerable.SequenceEqual(hash1, hash2)X-Expected-MD5HashAlgorithmName.MD5HashingMD5.Create()CryptographicOperationsusing var algorithm = HashAlgorithm.Create(HashAlgorithmName.MD5);
var hash = algorithm.ComputeHash(File.OpenRead(filePath));
// 后续处理同上HashAlgorithmName.MD5HashAlgorithm.Create()HashAlgorithm