密码学哈希计算与文件校验和工具

本密码学哈希计算与文件校验和套件依托浏览器底层原生 Web Crypto API (SubtleCrypto) 与工业级标准算法，提供纯前端的高性能哈希摘要计算、HMAC 签名与本地大文件完整性校验。所有数据计算 100% 运行在您的本机浏览器内存中，绝不向任何第三方或云端服务器上传敏感明文或文件流。

密码学散列函数的核心原理与 FIPS 国际标准

密码学散列函数（Cryptographic Hash Function）是一种确定性的数学单向映射算法，能将任意长度的二进制输入转换为固定长度的比特串（摘要）。其必须严格满足三大密码学特征：

1. 抗原像性（单向性 / One-Way Property）：已知散列值 $h$，在数学计算上无法推导逆运算还原出原始输入数据 $m$。哈希是不可逆的单向摘要，而非对称解密。
2. 抗第二原像性（弱抗碰撞性）：已知输入 $m_1$，无法在有效算力内构造出另一个不同的输入 $m_2$ 使得二者哈希值相同。
3. 强抗碰撞性（Collision Resistance）：无法在可行算力内找到任意两组不同的输入 $m_1 \neq m_2$，使其产生完全相同的散列摘要。
4. 雪崩效应（Avalanche Effect）：原始输入只要发生 1 个比特位的微小改动，输出散列值的约 50% 比特位将发生剧烈且不可预测的变化。

主流密码学散列算法横向对比与 NIST 安全评级

HMAC 消息认证码机制 (RFC 2104)

HMAC (Hash-based Message Authentication Code) 结合了密码学散列函数与通信双方预共享的对称密钥（Secret Key）。它不仅能验证数据在网络传输中是否被篡改（完整性），还能强有力地证明该数据确由持有私密密钥的合法发起方所创建（真实性与防伪造）。广泛应用于 GitHub Webhook、Stripe 支付回调、AWS API Signature V4 等接口鉴权协议中。

开发者后端集成示例代码

1. Node.js & TypeScript (node:crypto)

import { createHash, createHmac } from 'node:crypto';

// 计算 SHA-256 十六进制摘要
export function sha256Hex(content: string): string {
  return createHash('sha256').update(content, 'utf8').digest('hex');
}

// 校验 Webhook HMAC-SHA256 签名
export function verifyWebhook(payload: string, secret: string, headerSig: string): boolean {
  const computed = createHmac('sha256', secret).update(payload, 'utf8').digest('hex');
  return computed === headerSig;
}

2. Python 3 (hashlib & hmac)

import hashlib, hmac

# 高性能分块读取大文件并计算 SHA-256 校验和（内存占用极低）
def calculate_file_sha256(filepath: str) -> str:
    hasher = hashlib.sha256()
    with open(filepath, 'rb') as f:
        for chunk in iter(lambda: f.read(65536), b''):
            hasher.update(chunk)
    return hasher.hexdigest()

3. Go (crypto/sha256 & crypto/hmac)

package hasher

import (
	"crypto/hmac"
	"crypto/sha256"
	"encoding/hex"
)

func Sha256(text string) string {
	hash := sha256.Sum256([]byte(text))
	return hex.EncodeToString(hash[:])
}