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 下注意不要误用
rn换行逻辑——二进制写入完全绕过文本模式，无需额外处理
