go语言文件加密必须流式处理，禁用一次性加载；aes-cbc需pkcs#7填充、随机16字节iv前置存储，aes-gcm推荐但nonce须严格12字节且不可复用，密钥长度仅支持16/24/32字节，大文件必须os.open+io.copy分块加密，密文结构需固化salt、nonce与认证标签。
Go 语言不能在调用 os.Write 或 ioutil.WriteFile 时“自动”AES 加密——加密必须在写入前完成，且需严格控制 IV、填充、密钥长度和输出结构。所谓“动态加密”，本质是流式加解密 + 文件 I/O 编排，不是给 Write 函数加个钩子就能实现的。
为什么直接 io.Copy(aesWriter, file) 会 panic 或乱码
常见错误是把 aes.NewCipher(key) 返回的 cipher.Block 直接丢进 io.Copy：这根本走不通，因为：
-
aes.NewCipher只返回底层分组加密器，不带模式（CBC/GCM）、不处理 IV、不填 PKCS#7、不支持任意长度输入 -
io.Copy每次读取的字节数不确定（比如 4096 字节），而CryptBlocks要求输入长度必须是aes.BlockSize（16 字节）的整数倍，否则直接 panic - 没生成随机 IV，也没把它写进文件开头；解密端读不到 IV，就无法还原明文
- 最后一块数据大概率短于 16 字节，但 CBC 模式要求满块，不填充就会越界或静默失败
正确做法：用 cipher.StreamWriter 或自定义 io.Writer 封装加密流
要真正实现“边读边加、边加边写”，必须用 Go 标准库提供的流式封装，而不是手动拼接块。核心是选对模式：
- 用
cipher.NewCBCEncrypter+cipher.StreamWriter：适合兼容旧系统（如需与 Python 的Crypto.Cipher.AES互通），但必须自己做 PKCS#7 填充、生成 16 字节 IV 并前置写入 - 用
cipher.NewGCM+ 自定义io.Writer：更推荐，GCM 自动处理认证、无需填充，但 nonce 必须恰好gcm.NonceSize()（默认 12 字节），且绝对不可复用 - 别用
io.Copy直连原始cipher.Block；必须经由cipher.Stream或cipher.AEAD封装
示例关键片段（CBC 流式）：
iv := make([]byte, aes.BlockSize)
io.ReadFull(rand.Reader, iv)
outFile.Write(iv) // 先写 IV
block, _ := aes.NewCipher(key)
mode := cipher.NewCBCEncrypter(block, iv)
writer := &cipher.StreamWriter{S: mode, W: outFile}
io.Copy(writer, inFile) // 此时 writer 会自动填充并分块加密
密钥和 IV 的生成与存储必须满足硬性约束
哪怕流式逻辑写对了，密钥或 IV 错一个字节，整个加密就失效。生产环境最常踩的坑在这里：
- 密钥长度必须是 16 / 24 / 32 字节——
[]byte("mykey123")是 8 字节，aes.NewCipher直接 panic；推荐用sha256.Sum256([]byte(raw)).Sum(nil)[:32]派生 AES-256 密钥 - IV 必须每次加密都新生成：
iv := make([]byte, aes.BlockSize)+io.ReadFull(rand.Reader, iv)；绝不能复用、硬编码或从 key 派生（如key[:16]） - GCM 的 nonce 长度必须严格等于
gcm.NonceSize()（通常 12），多 1 字节或少 1 字节都会让gcm.Open返回cipher.ErrInvalidLength - IV/nonce 必须随密文一起存（一般前置），但本身不保密；密钥必须独立保管（环境变量、KMS 等）
大文件务必流式处理，小文件也别全 load 到内存
用 ioutil.ReadFile 读几 MB 的文件再加密，会瞬间吃光内存。真实场景应始终基于 os.File 句柄流式操作：
- 打开源文件用
os.Open，目标文件用os.Create或os.OpenFile(..., os.O_CREATE|os.O_WRONLY) - 加密后设置文件权限为
0600（os.Chmod(dst, 0600)），防止未授权读取 - 敏感中间数据（如临时密钥切片）加密完成后立即用
bytes.Fill清零，避免内存残留 - 所有
error必须检查——io.ReadFull失败、gcm.Seal失败、Write写入不完整，都得中断并清理
最易被忽略的是：GCM 模式下，Seal 输出的密文 = nonce + ciphertext + auth tag（16 字节），而 Open 时必须把整个字节流传进去——少读 1 字节，认证就失败。这个细节在调试时极难定位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
