file-hash-checker-20261106

文件哈希校验工具#

本技能是一个纯本地、离线的文件完整性校验工具：

• 能做什么：计算文件哈希值；对目录递归批量计算；生成标准校验清单（哈希 文件名）；依据清单核验文件是否被篡改或丢失，逐个给出 OK / FAILED / MISSING 状态并汇总；
• 带不带脚本：带一个 PowerShell 脚本 scripts/Get-FileChecksum.ps1，基于自带的 Get-FileHash，无需第三方模块；
• 联不联网：不联网，不发起任何网络请求；
• 写不写文件：计算结果默认输出到屏幕；只有传入 -Manifest 生成清单时才写入文件。

适用场景#

• 文件分发、归档、备份前后的完整性校验；
• 核对下载文件与官方提供的哈希值是否一致；
• 批量生成校验清单，供接收方离线核验；
• 质量管理（QA）中对批记录、电子文件、固件包等做完整性检查。

使用方法#

# 计算单个文件（默认 SHA256）
.\scripts\Get-FileChecksum.ps1 -Path .\package.zip

# 指定算法并比对预期值
.\scripts\Get-FileChecksum.ps1 -Path .\package.zip -Algorithm MD5 -Expected 'd41d8cd98f00b204e9800998ecf8427e'

# 递归计算目录下全部文件，生成校验清单
.\scripts\Get-FileChecksum.ps1 -Path .\dist -Recurse -Manifest .\dist\SHA256SUMS.txt

# 按清单核验（路径相对于清单所在目录解析）
.\scripts\Get-FileChecksum.ps1 -Verify .\dist\SHA256SUMS.txt

参数说明#

参数	说明	默认值
-Path	一个或多个文件/目录路径（计算模式）	空
-Algorithm	SHA256、SHA1、SHA384、SHA512、MD5	SHA256
-Recurse	目录递归处理子文件夹	关闭
-Expected	预期哈希值，传入时与实际值比对并输出 MATCH/MISMATCH	空
-Manifest	将结果写入校验清单（UTF-8 无 BOM）	空
-Verify	校验模式：指定清单文件路径，按清单核验	空

清单格式#

采用通用 sha256sum 风格，每行一个文件：

e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855  data/report.pdf

• 哈希与文件名之间为两个空格；也兼容 HASH *文件名 的二进制标记写法；
• 清单内使用相对路径（相对于清单文件所在目录），便于整目录迁移后校验；
• 校验结束输出汇总行；存在 FAILED 或 MISSING 时脚本退出码为 1，全部通过为 0，可直接用于自动化流程。

安全提示#

MD5、SHA1 仅适用于完整性校验，不能用于防篡改的安全场景；安全用途请选择 SHA256 或更高算法。