Argon2在Go中不“开箱即用”是因为x/crypto/argon2仅暴露底层原语，需手动管理salt生成、参数嵌入、base64编解码及恒定时间比对，而bcrypt提供GenerateFromPassword等封装函数。
Argon2 在 Go 中不是开箱即用的，但比 bcrypt 更抗 GPU 攻击；它需要手动管理参数、盐和编码格式，稍不注意就容易退化成弱哈希。
为什么 golang.org/x/crypto/argon2 不像 bcrypt 那样“开箱即用”
Go 标准库和官方维护的 x/crypto 模块里，bcrypt 提供了 GenerateFromPassword 这种一步到位的函数，而 argon2 包只暴露底层原语：你需要自己生成盐、调用 Key 函数、再手动拼接或编码输出。没有封装好的 HashPassword 或 ComparePassword。
这意味着：
- 必须显式控制
salt长度（推荐16字节），且每次都要新生成——不能复用全局 salt - 哈希结果是原始字节，要存进数据库得自己 base64 编码；验证时还得反向 decode + 重新计算比对
- 没有内置版本标识或参数嵌入机制，你得在存储格式里手动保留
time_cost、memory_cost等参数，否则未来无法升级或兼容
argon2.IDKey 的三个关键参数怎么设才合理
Argon2 有三种变体，argon2.IDKey（对应 Argon2id）是当前 OWASP 和 NIST 推荐的默认选择，兼顾抗侧信道与抗 GPU 攻击。它的三个核心参数不是越大越好，需结合部署环境权衡：
立即学习“go语言免费学习笔记（深入）”；
-
time_cost：迭代轮数，建议值2～4。设为1太快，8+在高并发登录场景下易拖慢响应 -
memory_cost：以 KiB 为单位的内存占用，推荐65536（64MB）起步；低于32768（32MB）会显著削弱抗 ASIC 能力 -
parallelism：并行线程数，通常设为 CPU 逻辑核数（如4或8）；超过物理核数收益递减，还可能引发调度争抢
示例调用：
salt := make([]byte, 16) rand.Read(salt) // 必须每次生成新 salt key := argon2.IDKey([]byte(password), salt, 2, 65536, 4, 32)
存储格式必须自己定义，否则无法验证或迁移
bcrypt 哈希字符串自带算法标识、cost、salt 和 hash（如 $2a$12$...），解码时自动提取。Argon2 没有这种约定格式，你若只存 raw key，下次验证就无从下手。
安全做法是构造可解析的存储字符串，例如：
$argon2id$v=19$m=65536,t=2,p=4$base64salt$base64hash
- 前缀声明算法和版本（
v=19是 Argon2 v1.3） -
m=、t=、p=明确记录当时参数，方便日后审计或渐进式升级 - 盐和哈希都用
base64.RawStdEncoding.EncodeToString编码，避免 URL/DB 存储问题
别省略版本字段——Argon2 将来若有 v20 规范，没带版本号的旧哈希将无法识别。
Argon2 验证时最容易漏掉的一步：恒定时间比对
很多人直接用 == 比较两个 base64 字符串，这会引入时序侧信道风险。即使你用了 Argon2id，若验证逻辑可被计时攻击利用，整套方案就形同虚设。
正确做法是：
- 先从存储字符串中解析出 salt 和预期 hash（都是
[]byte） - 用相同参数重新计算一次
argon2.IDKey - 用
crypto/subtle.ConstantTimeCompare比对两个[]byte结果
漏掉 ConstantTimeCompare 是 Argon2 在 Go 实现中最常被忽略的安全断点——它不改变哈希强度，但让整个防御链条出现可利用的缝隙。
