当前位置：首页 > 文章列表 > Golang > Go教程 > Golang文件加密解密教程详解

Golang文件加密解密教程详解

2026-04-12 20:23:33 0浏览收藏

本文深入介绍了如何在Golang中安全高效地实现文件的AES对称加密与解密，重点采用AES-CBC模式配合随机IV保障安全性，并提供了可直接运行的encryptFile和decryptFile函数示例；同时强调了生产级实践的关键细节——如密钥长度合规性、PBKDF2派生密钥、大文件分块/流式处理、MAC完整性校验及IV安全存储，帮助开发者避开常见陷阱，构建既可靠又可扩展的文件加解密能力。

如何在Golang中实现文件加密与解密

在Golang中实现文件加密与解密，推荐使用对称加密算法（如AES），因为它效率高且适合大文件处理。核心思路是：用一个密钥对文件内容进行加密，保存或传输后，再用相同密钥解密还原内容。以下是具体实现步骤和代码示例。

AES-CBC模式文件加密

使用AES算法配合CBC（Cipher Block Chaining）模式可以有效保护文件数据。需要生成随机的初始化向量（IV）并将其与密文一起存储，以便后续解密。

说明：

密钥长度支持16、24、32字节，分别对应AES-128、AES-192、AES-256
明文需填充至块大小（16字节）的整数倍
IV应随机生成并随密文保存

示例代码：

package main

import (
    "crypto/aes"
    "crypto/cipher"
    "crypto/rand"
    "io"
    "os"
)

func encryptFile(key, inFilePath, outFilePath string) error {
    plaintext, err := os.ReadFile(inFilePath)
    if err != nil {
        return err
    }

    block, err := aes.NewCipher([]byte(key))
    if err != nil {
        return err
    }

    ciphertext := make([]byte, aes.BlockSize+len(plaintext))
    iv := ciphertext[:aes.BlockSize]
    if _, err := io.ReadFull(rand.Reader, iv); err != nil {
        return err
    }

    stream := cipher.NewCFBEncrypter(block, iv)
    stream.XORKeyStream(ciphertext[aes.BlockSize:], plaintext)

    return os.WriteFile(outFilePath, ciphertext, 0644)
}

AES-CBC模式文件解密

解密时从文件读取前16字节作为IV，然后使用相同密钥还原数据。注意验证密钥正确性和数据完整性应在应用层处理。

示例代码：

func decryptFile(key, inFilePath, outFilePath string) error {
    ciphertext, err := os.ReadFile(inFilePath)
    if err != nil {
        return err
    }

    block, err := aes.NewCipher([]byte(key))
    if err != nil {
        return err
    }

    if len(ciphertext) < aes.BlockSize {
        return io.ErrUnexpectedEOF
    }

    iv := ciphertext[:aes.BlockSize]
    ciphertext = ciphertext[aes.BlockSize:]

    stream := cipher.NewCFBDecrypter(block, iv)
    stream.XORKeyStream(ciphertext, ciphertext)

    return os.WriteFile(outFilePath, ciphertext, 0644)
}

使用示例与注意事项

调用上面函数进行加解密操作，密钥必须为16/24/32字节长度字符串。

简单调用示例：

func main() {
    key := "1234567890123456" // 16字节密钥
    encryptFile(key, "plain.txt", "encrypted.dat")
    decryptFile(key, "encrypted.dat", "decrypted.txt")
}

关键点提醒：