应使用golang.org/x/text/encoding/gbk包配合transform，因其已取代deprecated的simplifiedchinese.GBK，支持完整GBK扩展字，线程安全需新建实例，且必须基于原始[]byte流式转换而非string强制解释。
Go 里做 UTF-8 ↔ GBK 转换，别自己写解码逻辑，也别用 strings.ToValidUTF8 或 unicode/utf8 包“修乱码”——它们根本不处理编码转换，只校验或替换非法 UTF-8 字节。真正能用、稳定、无 CGO、支持流式处理的方案只有一个：golang.org/x/text/encoding/gbk 配合 transform。
为什么 string(gbkBytes) 打印出来全是问号或方块
根本原因：Go 的 string() 是字节到字符串的强制解释，不是解码。你把 GBK 字节（比如 []byte{0xC4, 0xE3}）直接转成 string，运行时就按 UTF-8 解释，但这两个字节在 UTF-8 中不合法，于是显示为 或其他占位符。
- 错误操作：
data, _ := os.ReadFile("log.txt"); fmt.Println(string(data))—— 这只是把 GBK 字节当 UTF-8 吐出来，不是转换 - 正确路径：先用
gbk.Decoder把字节流解码成合法 UTF-8 字节，再转string - BOM 处理：GBK 没有合法 BOM；如果文件开头是
0xEF 0xBB 0xBF（UTF-8 BOM），必须提前跳过前 3 字节，否则gbk.Decoder会报encoding.InvalidUnreadableError
gbk.Decoder.Bytes 和 gbk.Encoder.Bytes 怎么用才不出错
方向不能反，参数类型不能错，错误必须检查——这是最容易翻车的三处。
- 解码 GBK → UTF-8：
dst, err := gbk.Decoder.Bytes(srcGBKBytes)，srcGBKBytes必须是原始 GBK 字节切片，err类型是encoding.InvalidUnreadableError，不是 panic，要显式判断 - 编码 UTF-8 → GBK：
dst, err := gbk.Encoder.Bytes([]byte(utf8Str))，注意传入的是[]byte(utf8Str)，不是utf8Str本身；err可能是encoding.ErrUnsupported（如 emoji、生僻字无 GBK 码位） - 别缓存
gbk.Decoder实例反复调用.Bytes()——它不是线程安全的；每次调用应新建gbk.NewDecoder()或复用transform.Transformer实例
大文件（几百 MB）怎么避免 OOM
用 io.ReadAll + gbk.Decoder.Bytes 一次性加载再转换，内存峰值等于文件大小 × 2（原始字节 + UTF-8 字节），极易触发 OOM。正确做法是让转换发生在数据流动过程中。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 读 GBK 文件：
reader := transform.NewReader(file, gbk.Decoder); scanner := bufio.NewScanner(reader)，逐行解码，内存恒定 - 写 GBK 文件：
w := transform.NewWriter(file, gbk.Encoder); fmt.Fprint(w, "你好")，写入即编码，不额外分配 - HTTP 响应流式输出 GBK：
http.ServeContent(w, r, "", modTime, transform.NewReader(f, gbk.Decoder))，适合导出旧系统报表 - 注意：不要对
transform.NewReader做多次io.Copy，它内部状态不可重置；需重新包装
simplifiedchinese.GBK 和 golang.org/x/text/encoding/gbk 用哪个
用 golang.org/x/text/encoding/gbk。它已在 2025 年后正式取代 simplifiedchinese.GBK，后者已被标记为 deprecated。
- 新包对 GBK 扩展区汉字（如“镕”“煊”“珮”）支持完整，旧包可能静默替换为
? - 安装命令：
go get golang.org/x/text/encoding/gbk - 导入路径：
import "golang.org/x/text/encoding/gbk"，不是simplifiedchinese - 容错需求慎用：
transform.Chain(gbk.Encoder, transform.RemoveInvalidUTF8)会丢字，生产环境宁可报错也不静默丢数据
最易被忽略的一点：所有转换都基于字节流，不是字符串。一旦你拿到的是一个已经乱码的 string（比如含大量 ），说明原始 GBK 字节早已被错误解释过一次，此时再用 gbk.Decoder 已无法还原——必须从原始 []byte 开始解码。
