如何使用Golang写入二进制文件_Golang io Write二进制写入示例

Go写二进制文件须用binary.Write、io.Write或[]byte操作，禁用字符串转换；binary.Write要求结构体字段导出、字节序明确、不支持map/slice；io.Write需检查返回值；变长数据需手动编码长度前缀。

Go 语言写入二进制文件，核心是避免用 fmt.Fprintf 或 strconv 转字符串，必须用 binary.Write、io.Write 原始字节流，或直接操作 []byte。

用 `binary.Write` 写结构体到二进制文件

适合固定格式的序列化（如网络协议头、自定义二进制格式），要求字段对齐、字节序明确。它不处理嵌套切片/指针，只支持基础类型和数组/结构体。

必须传入 io.Writer（如 *os.File），不能传字符串或缓冲区
字节序需显式指定：binary.LittleEndian 或 binary.BigEndian
结构体字段必须是可导出的（首字母大写），否则 binary.Write 会忽略
不支持 map、slice（除非长度固定且已知，用数组代替）

package main

import (
    "encoding/binary"
    "os"
)

type Header struct {
    Magic  uint32
    Length uint16
    Flags  byte
}

func main() {
    f, _ := os.Create("header.bin")
    defer f.Close()

    hdr := Header{Magic: 0x474f4c41, Length: 1024, Flags: 0x01}
    binary.Write(f, binary.LittleEndian, hdr) // 写入 7 字节：4+2+1
}

用 `io.Write` 直接写 `[]byte`

最底层、最可控的方式，适用于已知原始字节序列的场景（如拼接协议帧、写图片头、加密后数据）。

Write 返回实际写入字节数和可能的错误，必须检查是否写满（尤其在循环中）
不要假设 Write 一次写完全部数据；小文件通常没问题，但管道、网络或满磁盘时可能部分写入
若需多次写入，推荐用 bufio.Writer 减少系统调用，但要注意 Flush() 否则数据滞留

package main

import (
    "os"
)

func main() {
    f, _ := os.Create("raw.bin")
    defer f.Close()

    data := []byte{0x00, 0x01, 0x02, 0xff, 0xaa}
    n, err := f.Write(data)
    if err != nil || n != len(data) {
        panic("write failed or partial")
    }
}

写入非对齐或变长二进制数据（如字符串 + 长度前缀）

当需要混合类型或动态长度时，binary.Write 不够用，得手动编码字节布局。

字符串不能直接写——要先写长度（uint32），再写字节内容，否则读取端无法知道边界
注意大小端一致性：写用 LittleEndian，读也必须用同一个
用 append 拼接字节切片比多次 Write 更高效，也更容易控制顺序

package main

import (
    "encoding/binary"
    "os"
)

func writeStringWithLen(w *os.File, s string) {
    b := []byte(s)
    header := make([]byte, 4)
    binary.LittleEndian.PutUint32(header, uint32(len(b)))

    w.Write(header)
    w.Write(b)
}

func main() {
    f, _ := os.Create("str.bin")
    defer f.Close()

    writeStringWithLen(f, "hello世界")
}

二进制写入真正容易出错的地方，不是语法，而是字节序误配、结构体字段未导出、或对 Write 返回值视而不见——尤其在跨平台或对接 C/C++ 程序时，一个字节错位，整段数据就不可读。

# go # golang # 编码 # app # 字节 # ai # c++ # 字符串 # 结构体 # 循环 # 指针 # 切片 # append # map # 不支持 # 返回值 # 变长 # 就不 # 适用于 # 自定义 # 要先 # 它不 # 或对 # 视而不见

返回目录在线咨询

上一篇：Java用正则表达式实现${name}形式的字符串模板实例
下一篇：建站服务器如何选？高效配置与SEO优化全指南

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

如何使用Golang写入二进制文件_Golang io Write二进制写入示例

用 binary.Write 写结构体到二进制文件

用 io.Write 直接写 []byte

写入非对齐或变长二进制数据（如字符串 + 长度前缀）

您的项目需求

用 `binary.Write` 写结构体到二进制文件

用 `io.Write` 直接写 `[]byte`