snakemake文档中曾误用非标准字符串作为sha256示例，实际应使用标准32字节（64字符）小写十六进制编码；本文澄清其规范格式、常见误区及验证方法。

snakemake文档中曾误用非标准字符串作为sha256示例，实际应使用标准32字节（64字符）小写十六进制编码；本文澄清其规范格式、常见误区及验证方法。

在Snakemake中使用ensure(..., sha256=...)进行输出文件完整性校验时，sha256参数必须是标准的十六进制（hex）字符串，即长度为64、仅含小写字母a–f与数字0–9的ASCII字符串。例如：

my_checksum = "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
# ✅ 正确：64字符，纯十六进制，小写，UTF-8安全

该值对应输入 b"test" 的 SHA256 哈希结果（可通过 echo -n "test" | sha256sum 验证）。

⚠️ 注意：原始文档中出现的 "u98a9cjsd98saud090923ßkpoasköf9ß32" 并非合法SHA256编码——它混入了非ASCII字符（如ß、ö），既不是Base64，也不是hex，更非原始字节的直接解码。经追溯，这是Snakemake早期文档（PR #1651）中的笔误，疑似键盘误触（如德语布局下ß/ö键邻近数字键），已于 PR #2987 中正式修正为标准hex格式。

? 关键要点总结：

• ✅ SHA256哈希值在Snakemake中始终以64位小写十六进制字符串传入；
• ❌ 不支持原始字节（bytes）、Base64、URL-safe Base64或任意二进制字符串；
• ? 可通过Python快速验证合法性：

  import re
  checksum = "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
  assert re.fullmatch(r"[a-f0-9]{64}", checksum), "Invalid SHA256 hex format"

• ?️ Snakemake内部会将该字符串解析为32字节后，与目标文件的实际SHA256摘要逐字节比对，确保强一致性。

因此，在编写规则时，请务必使用工具生成的标准hex摘要（如sha256sum file.txt | cut -d' ' -f1），避免手动输入或复制错误示例。