本文详解如何在 go 中正确使用 crypto/aes 和 crypto/cipher 实现文件加密，重点解决 iv 安全生成、密文流式写入、密钥管理及完整可运行示例，避免常见陷阱如硬编码 iv、未处理错误、内存溢出风险等。
本文详解如何在 go 中正确使用 crypto/aes 和 crypto/cipher 实现文件加密，重点解决 iv 安全生成、密文流式写入、密钥管理及完整可运行示例，避免常见陷阱如硬编码 iv、未处理错误、内存溢出风险等。
在 Go 中使用 crypto/aes 加密文件时，仅调用 XORKeyStream 并不能自动完成文件读写——它只对字节切片执行就地异或变换。原始代码中 aesEncrypter.XORKeyStream([]byte(dst), []byte(src)) 存在多个严重问题：
- 将文件路径字符串转为 []byte 并非读取文件内容；
- IV 由密钥前 16 字节截取（iv := []byte(key)[:aes.BlockSize]），导致每次加密 IV 完全可预测，严重削弱 CFB 模式的安全性；
- 未打开目标文件写入密文，也未处理任何 I/O 错误。
✅ 正确做法是：IV 必须随机生成且随密文一同存储（通常前置），明文需完整读入内存或流式处理，密文需显式写入目标文件。以下是生产就绪的改进实现：
package main
import (
"crypto/aes"
"crypto/cipher"
"crypto/rand"
"io"
"os"
"path/filepath"
)
// encrypt 加密指定文件，输出为同名.aes 文件（含随机 IV 前缀）
func encrypt(source, localDir string) error {
srcPath := filepath.Join("/home/bacula/cloud-backup/", localDir, source)
dstPath := srcPath + ".aes"
// 1. 读取明文（注意：大文件请改用流式处理，见下方说明）
plaintext, err := os.ReadFile(srcPath)
if err != nil {
return err
}
// 2. 密钥（实际应用中应通过安全方式获取，如环境变量/密钥管理服务）
key := []byte("example key 1234") // ⚠️ 仅作演示！长度必须为 16/24/32 字节
if len(key) != 16 && len(key) != 24 && len(key) != 32 {
return io.ErrUnexpectedEOF // 或自定义错误
}
// 3. 创建 AES 块加密器
block, err := aes.NewCipher(key)
if err != nil {
return err
}
// 4. 安全生成随机 IV（CFB 模式要求 IV 唯一且不可预测）
iv := make([]byte, aes.BlockSize)
if _, err := io.ReadFull(rand.Reader, iv); err != nil {
return err
}
// 5. 初始化 CFB 加密器，并分配密文空间（IV + 加密数据）
ciphertext := make([]byte, aes.BlockSize+len(plaintext))
copy(ciphertext[:aes.BlockSize], iv) // IV 置于密文头部
// 6. 执行加密
stream := cipher.NewCFBEncrypter(block, iv)
stream.XORKeyStream(ciphertext[aes.BlockSize:], plaintext)
// 7. 写入密文到文件（含 IV）
outFile, err := os.Create(dstPath)
if err != nil {
return err
}
defer outFile.Close()
if _, err := outFile.Write(ciphertext); err != nil {
return err
}
return nil
}
? 关键要点与最佳实践：
- IV 必须随机且唯一：永远不要复用 IV 或从密钥派生。io.ReadFull(rand.Reader, iv) 是 Go 标准推荐方式；
- IV 需与密文共存：解密时需先读取前 16 字节作为 IV，因此将 IV 附加在密文头部是通用约定；
- 大文件处理警告：上述示例使用 os.ReadFile 将整个文件加载进内存，适用于中小文件（crypto/cipher 文档示例）；
- 密钥管理：示例中硬编码密钥仅用于演示。生产环境务必使用 golang.org/x/crypto/scrypt 或 crypto/rand 生成密钥，并通过安全信道传递；
- 完整性校验缺失：CFB 仅提供机密性，不防篡改。如需认证加密（AEAD），应选用 crypto/aes + crypto/cipher.GCM 组合（推荐）。
最后，调用示例：
func main() {
if err := encrypt("important.log", "daily"); err != nil {
panic(err)
}
println("Encryption completed: important.log.aes created")
}
遵循以上模式，即可构建安全、可靠、符合密码学工程规范的 Go 文件加密模块。
