Go标准库不支持GBK等非UTF-8编码，必须使用golang.org/x/text/encoding；正确做法是通过simplifiedchinese.GBK.NewDecoder().Bytes()解码，避免手动查表或Scanner直接读GBK文件。
golang 中没有内置编码转换，必须用 golang.org/x/text/encoding
Go 标准库不支持 GBK、GB2312、BIG5、Shift-JIS 等非 UTF-8 编码的读写。直接用 os.ReadFile 或 strings.NewReader 处理 GBK 文件，会得到乱码或 ，不是 bug，是设计如此。
真正可用的方案只有官方维护的 x/text 子模块，它提供编码探测（有限）、编解码器注册、流式转换能力。别找 iconv 绑定或 Cgo 方案——跨平台差、部署重、维护难。
- 安装：
go get golang.org/x/text/encoding（无需单独encoding/simplifiedchinese，后者只是前者的子包） - 常用编码包路径：
- GBK：
golang.org/x/text/encoding/simplifiedchinese→simplifiedchinese.GBK - GB2312：
simplifiedchinese.HZGB2312（注意不是GB2312，标准名是HZGB2312） - UTF-16LE/BE：
unicode.UTF16（需指定unicode.LittleEndian和unicode.UseBOM）
- GBK：
从 GBK 字节数组转 UTF-8 字符串：用 Decoder，别手动查表
错误做法：把字节当 int 拆开、查 GBK 码表、拼 rune——效率低、易出错、不处理代理对和 BOM。
正确路径是走 encoding.Decoder 的标准流程：创建解码器 → 调用 Bytes() 或包装成 io.Reader → 一次性转换。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
simplifiedchinese.GBK.NewDecoder().Bytes(data)返回[]byte和error；若输入含非法 GBK 序列（如孤立 0xA1），默认返回encoding.ErrInvalidUTF8，可提前用decoder.WithFallback(...)控制容错行为 - 若要保留原始错误位置，改用
transform.NewReader(bytes.NewReader(data), decoder.Transform())+io.ReadAll，适合大文件流式处理 - 注意：
GBK.NewDecoder()是无状态的，线程安全；但不要复用同一个Decoder实例处理多个不同编码数据——它不自动识别编码
data := []byte{0xC4, 0xE3, 0xBA, 0xC3} // "你好" 的 GBK 编码
dst, err := simplifiedchinese.GBK.NewDecoder().Bytes(data)
if err != nil {
log.Fatal(err) // 可能是 encoding.ErrInvalidUTF8
}
fmt.Println(string(dst)) // 输出："你好"
读取 GBK 编码文件时，别在 os.Open 后直接 bufio.Scanner
bufio.Scanner 默认按行切分，但它的 Split 函数基于 UTF-8 字节判断换行符（\n、\r\n）。GBK 文件里一个汉字占 2 字节，若换行符恰好落在某个汉字中间（比如 0xA1 0x0A），Scanner 就会切错，后续所有解码都偏移。
- 安全做法：先完整读入
[]byte，再整体解码为 UTF-8string，最后用strings.Split或正则切分 - 内存敏感场景：用
io.ReadSeeker包装解码后的strings.NewReader(utf8Str)，再传给 Scanner —— 此时底层已是合法 UTF-8 - 别用
encoding/gob或json直接 decode GBK 数据——它们只认 UTF-8，会 panic 报invalid character
写入 GBK 文件时，Encoder 的 BOM 和错误处理必须显式控制
simplifiedchinese.GBK.NewEncoder() 默认不写 BOM，且遇到无法表示的 Unicode 字符（如 emoji、生僻汉字）会直接返回 transform.ErrShortDst 或 transform.ErrShortSrc，而不是跳过或替换。
- 写 BOM：用
simplifiedchinese.GBK.NewEncoder().WithBOM(true)（仅对 UTF-16 族有效，GBK 本身无标准 BOM；此调用实际无效，勿用）→ 实际上 GBK 文件不应带 BOM，Windows 记事本识别靠内容启发，加 BOM 反而可能被其他工具误判 - 容错写入：用
encoder.WithFallback(transform.SkipOnError)或transform.ReplaceOnError('?')，否则一个 ? 就会让整个Write失败 - 注意
Encoder的Bytes()方法返回的是目标编码字节，但不会自动添加末尾\n或补空格——换行符需由业务逻辑保证是 GBK 编码的0x0D 0x0A，不能直接写"\r\n"
最常被忽略的一点：GBK 编码器对 Unicode 中「兼容汉字」（如全角 ASCII、康熙字典外字）支持不一，U+3000–U+303F（中文标点）基本 OK，但 U+3400–U+4DBF（扩展 A）部分字缺失映射，此时 fallback 是唯一可靠选择。
