Go中写入二进制数据应优先使用io.Writer接口，注意检查Write返回的字节数、避免io.WriteString、用binary.Write处理结构体、必要时加bufio.Writer缓冲并显式Flush。
Go 中写入二进制数据最直接的方式是用 io.Writer 接口，但实际操作时容易混淆类型、忽略错误、误用缓冲或忽略字节序——尤其是当你需要精确控制每个字节时。
用 os.File 或 bytes.Buffer 实现基础二进制写入
所有二进制写入都依赖底层实现了 io.Writer 的类型。os.File 和 bytes.Buffer 是最常用两种：前者落盘，后者内存暂存。它们的 Write 方法接收 []byte，不关心内容是否为文本或二进制。
注意：Write 不保证一次写完全部字节，返回值 n, err 中的 n 可能小于输入切片长度，必须检查。
file, _ := os.Create("data.bin")
defer file.Close()
data := []byte{0x01, 0x02, 0xFF, 0x00}
n, err := file.Write(data)
if err != nil {
log.Fatal(err)
}
if n != len(data) {
log.Fatal("short write")
}
写入结构体二进制布局：用 binary.Write 配合 io.Writer
手动拼 []byte 写结构体易出错，推荐用 encoding/binary 包。它要求目标类型是导出字段的 struct（即首字母大写），且字段类型必须是基础数值类型或数组。
立即学习“go语言免费学习笔记（深入）”；
关键点：
-
binary.Write自动处理字节序（binary.LittleEndian或binary.BigEndian） - 不能写含指针、切片、map、channel 的 struct —— 这些不是固定大小的二进制布局
- struct 字段顺序 = 二进制写入顺序，无 padding，和 C struct 不同（Go 不自动对齐）
type Header struct {
Magic uint32
Length uint16
Flags uint8
}
buf := new(bytes.Buffer)
err := binary.Write(buf, binary.LittleEndian, Header{
Magic: 0x42494E00, // "BIN\0"
Length: 1024,
Flags: 0x01,
})
if err != nil {
log.Fatal(err)
}
避免常见陷阱：io.WriteString 不能用于二进制数据
io.WriteString 内部调用 string 转 []byte，但 string 在 Go 中是只读 UTF-8 序列，**不能安全表示任意二进制数据**。例如包含 \x00 或高位字节的 byte slice 转成 string 后，可能被截断或引发不可预期行为（尤其在 CGO 或与 C 交互时）。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
正确做法始终使用 Write + []byte，或 binary.Write。
反例（危险）：
// ❌ 错误：把原始字节强制转 string 再写
b := []byte{0x00, 0xFF, 0x80}
io.WriteString(w, string(b)) // 可能在某些上下文中被截断或编码污染
正例（安全）：
// ✅ 正确：直接写字节切片
w.Write([]byte{0x00, 0xFF, 0x80})
性能与缓冲：何时用 bufio.Writer
频繁小写（如逐字节写）直连 os.File 开销大，因为每次 Write 都触发系统调用。用 bufio.Writer 可批量缓冲后一次性刷出。
但要注意：
- 必须显式调用
Flush()，否则最后部分数据可能滞留在缓冲区未落盘 - 缓冲区大小影响性能：默认 4KB，写大量数据可设更大（如
bufio.NewWriterSize(f, 64*1024)） - 若写入后立即读取文件，务必先
Flush()再Seek(0, 0)，否则读不到最新内容
f, _ := os.Create("out.bin")
defer f.Close()
w := bufio.NewWriterSize(f, 32*1024)
defer w.Flush() // ⚠️ 必须 defer 或显式调用
for i := 0; i < 1000; i++ {
w.Write([]byte{byte(i % 256)})
}
真正难的不是“怎么写”，而是确认你写的每个字节都符合协议或硬件要求——比如某字段必须是大端、某偏移处必须是 0x00 填充、某长度字段需在写完 payload 后回填。这些逻辑不会被任何 Writer 自动处理，得你自己算好位置、预留空间、再 seek 回写。
