go中不能序列化*os.file，因其为不可复制的系统资源句柄；正确做法是序列化其读取的数据内容（如用gob/json），或通过io.copy+sync+rename实现原子落盘。
Go 里不能序列化 *os.File 或任意运行时对象指针，所谓“把对象存到文件”本质是保存它的**可重建状态数据**，不是 dump 内存。选错方式轻则读不出、重则 panic 或静默损坏。
用 gob 还是 json？看场景再决定
gob 是 Go 原生二进制格式，快、小、保留类型和结构，但只适合 Go 程序内部读写；json 人眼可读、跨语言，但丢零值语义（如 nil []string 和 []string{} 都变成 []），且字段必须导出（首字母大写）。
- 仅 Go 内部用、结构稳定 → 优先
encoding/gob，写前确认类型已注册（gob.Register()）、字段名大小写完全一致 - 要调试、要跨语言、要配置文件 → 用
encoding/json，加json:"key"tag 控制字段名 - 别混用：定义了
Port int `json:"port"`就别拿gob去 encode，会跳过字段
写文件必须原子，否则崩溃就毁数据
直接 os.WriteFile("config.json", data, 0644) 是危险操作：写到一半进程挂了，原文件就只剩半截。生产环境必须走三步闭环：
- 用
os.CreateTemp("", "config-*.json")创建临时文件 - 写完立刻检查
n, err := tmpFile.Write(data)是否等于len(data)，再调tmpFile.Sync() - 最后用
os.Rename(tmpPath, finalPath)替换 —— 注意：仅同分区才原子，跨磁盘会退化为 copy+delete
切片、map、struct 直接转 []byte 是错的
[]int、map[string]int 这类类型不是纯数据，而是含指针、长度、容量的运行时结构体。强制 []byte(mySlice) 编译报错，绕过（如 unsafe）写进去的只是内存地址快照，重启后必然乱码或 panic。
- 必须走序列化：用
gob.NewEncoder(file).Encode(data)或json.NewEncoder(file).Encode(data) - 读取时，目标变量必须是地址（
&dst），且类型与写入时完全一致 - 若数据来自
bytes.Buffer，用buf.Bytes()（返回底层数组引用），别用buf.String()（触发 UTF-8 验证，可能截断非文本字节）
路径、权限、父目录，一个都不能漏
Windows 下拼字符串路径（如 "data/" + name + ".json"）容易因分隔符或中文失败；os.WriteFile 默认权限只对新建文件生效，且不创建父目录。
- 路径一律用
filepath.Join("data", name+".json")，自动适配平台 - 写入前先
os.MkdirAll(filepath.Dir(path), 0755) - 权限显式传，如
0600（私有配置）或0644（公开数据），别依赖 umask - 用户输入的文件名需过滤控制字符：
strings.ToValidUTF8(name)或正则[\x00-\x1f]
真正难的不是“怎么写”，而是判断哪些字段该存、哪些不该存（比如 sync.Mutex、context.Context、http.Client），以及如何保证序列化/反序列化两端类型定义长期一致 —— 这些没法靠工具自动检查，得靠设计约束和代码审查卡住。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
