NPM包dist字段中shasum、integrity、signatures的差异与用途

1. dist.shasum与dist.integrity的核心差异、共存原因及校验必要性 #

• 核心差异：
  • dist.shasum是单纯的SHA-1哈希字符串，仅基于SHA-1算法生成；
  • dist.integrity采用算法标识-编码哈希的格式（如sha256-xxxxxxxx），支持SHA-256、SHA-512等更安全的哈希算法，格式明确标注了所用算法。
• 共存原因：shasum是npm 5版本之前的遗留字段，早期npm仅靠它校验包完整性；integrity是npm 5推出的更安全的校验方案，保留shasum是为了兼容仍在使用旧版本npm的客户端。
• 校验必要性：不需要同时校验。新版本npm（v5+）会优先使用integrity进行校验，旧版本npm只能识别shasum。日常使用新版本npm时，只校验integrity即可，无需额外处理shasum。

2. dist.integrity与shasum的实际区别及存在意义 #

实际区别 #

• 算法支持：shasum仅支持已被证明存在碰撞风险、安全性较低的SHA-1；integrity支持SHA-256、SHA-512等高强度哈希算法，能有效抵御篡改攻击。
• 格式规范：shasum是纯哈希值，无算法标识；integrity的格式明确标注了哈希算法，避免校验时的算法歧义。
• 校验逻辑：npm对integrity的校验更严谨，会严格按照指定算法验证tarball哈希；shasum仅做简单的SHA-1值匹配，逻辑相对单一。

存在意义 #

• shasum：用于兼容npm v5之前的旧版本客户端，确保这些环境下仍能完成包完整性校验。
• integrity：解决SHA-1的安全缺陷，作为npm v5及以后的标准校验方式，大幅提升包在传输、存储过程中的完整性保障能力。

3. dist.signatures[*].sig的作用、使用方式、密钥持有方、适用场景及多签名原因 #

• 作用：是包发布者用私钥生成的数字签名，用于证明包的发布者身份合法，防止第三方冒充发布者上传或篡改包文件。
• 使用方式：npm客户端在安装包时会自动用对应公钥验证签名有效性；手动验证可使用npm verify-signature命令，结合发布者的公钥完成签名校验。
• 密钥持有方：包的维护者、发布者（或npm组织的授权管理员），这些用户需在npm平台预先配置自己的GPG密钥对。
• 适用场景：当需要确认包来源的可信度时使用，比如在高安全要求的生产环境中，确保安装的包未被恶意篡改或冒充发布。npm默认会自动验证签名，若验证失败会触发警告或阻止安装。
• 多签名原因：可能是包有多个授权发布者，每个人都用自己的私钥签名；也可能是发布流程中不同环节（如CI自动发布、人工手动发布）分别进行签名。多签名能提升包的可信度，部分场景下会要求多个签名全部验证通过，进一步确保来源合法。

dist.npm-signature与其他字段的关联 #

dist.npm-signature是npm官方对包的元数据（包含shasum、integrity、dist.signatures等字段）生成的签名，作用是证明整个包的元数据在npm仓库中未被篡改。它与其他字段的关联逻辑是：

1. npm官方会先校验shasum和integrity的正确性，确保包内容完整；
2. 再校验dist.signatures中的发布者签名，确认包来源合法；
3. 最后对包含这些字段的完整元数据进行签名，生成npm-signature，确保元数据本身未被篡改。
   简单来说，shasum/integrity保障包内容完整，dist.signatures保障发布者身份合法，npm-signature则是官方对整个元数据的二次信任背书。

内容的提问来源于stack exchange，提问作者Lance Pollard