如何在Golang中写入二进制文件_保存字节流数据

P粉602998670 2025-12-27 00:00:00 次阅读

Go写二进制文件需直接操作[]byte，用os.WriteFile适合小中数据，os.File.Write支持分块/追加/随机写，encoding/binary用于序列化结构体，禁用fmt/io.WriteString避免UTF-8转码。

在 Go 语言中写入二进制文件，本质是把 []byte（字节切片）直接写入磁盘，不经过文本编码转换。关键在于使用底层的 I/O 接口，避免字符串隐式转码或换行符干扰。

使用 os.WriteFile 快速保存字节流

适合小到中等体积数据（如配置、序列化结构体、图片片段等），代码简洁安全：

data := []byte{0x48, 0x65, 0x6C, 0x6C, 0x6F, 0x20, 0x57, 0x6F, 0x72, 0x6C, 0x64} // "Hello World" 的 ASCII 字节
err := os.WriteFile("output.bin", data, 0644)
if err != nil {
    log.Fatal(err)
}

自动处理文件打开、写入、关闭全过程
覆盖写入（若文件存在），不追加
权限参数 0644 表示用户可读写、组和其他用户只读

用 os.File.Write 精确控制写入过程

适合大文件、需要分块写入、或需追加/偏移写入等场景：

f, err := os.Create("output.bin")
if err != nil {
    log.Fatal(err)
}
defer f.Close()

// 写入原始字节
n, err := f.Write([]byte{0xFF, 0xFE, 0xFD})
if err != nil {
    log.Fatal(err)
}
fmt.Printf("写入 %d 字节\n", n)

os.Create 总是创建新文件（若存在则清空）；用 os.OpenFile 可指定 os.O_APPEND 追加
Write 返回实际写入字节数，应检查是否等于预期长度（尤其在部分写入场景下）
支持 WriteAt 实现随机位置写入（如 patch 二进制文件）

写入序列化后的结构体（如 encoding/binary）

当需保存 Go 结构体为紧凑二进制格式（非 JSON/Text），推荐 encoding/binary：

type Header struct {
    Magic  uint32
    Length uint16
    Flags  byte
}

hdr := Header{Magic: 0x12345678, Length: 1024, Flags: 0x01}
buf := new(bytes.Buffer)
binary.Write(buf, binary.LittleEndian, hdr)
err := os.WriteFile("header.bin", buf.Bytes(), 0644)

必须显式指定字节序：binary.LittleEndian 或 binary.BigEndian
仅支持基础类型和固定大小数组；结构体字段不能含 slice、map、string（需单独处理）
配合 bytes.Buffer 可先构造完整字节流再落盘，避免多次系统调用

注意事项与常见坑

别用 fmt.Fprint 或 io.WriteString 写二进制——它们会把字节解释为 UTF-8 字符串，遇到 0x00 或非法序列可能 panic 或截断
写入前确保字节切片内容正确：可通过 hex.Dump(data) 打印十六进制预览
大文件建议分块写（如每次 64KB），减少内存压力；用 bufio.NewWriter 可提升小量多次写的性能
Windows *意不要误用 \r\n 换行逻辑——二进制写入完全绕过文本模式，无需额外处理