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：
立即学习“go语言免费学习笔记（深入）”；
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换行逻辑——二进制写入完全绕过文本模式，无需额外处理
