golang.org/x/net/html/charset 不提供编码自动检测功能，仅支持基于已知标签（IANA注册名）的解码或依据HTTP/HTML元信息协商编码；需用第三方库如github.com/saintfish/chardet实现探测。
为什么 golang.org/x/net/html/charset 不能直接“检测”编码
它不提供自动探测（auto-detect）功能，只做「已知编码下的解码」或「根据 HTTP/HTML 元信息做编码协商」。真正靠猜的检测（比如从字节流判断是 GBK 还是 UTF-8）得靠第三方库，charset 包本身不干这事。
常见错误现象：charset.NewReaderLabel 返回 nil，或解码后乱码却没报错——其实是传了错误的 label（如把 "utf8" 当成有效 label），而包内部静默 fallback 到 UTF-8。
-
label必须是 IANA 注册名（如"gbk"、"euc-kr"），"utf8"❌，得写"utf-8"✅ - HTTP
Content-Type中的charset=gb2312会被映射为"gbk"，但 HTML<meta charset="gb2312">不会自动映射，需手动 normalize - 如果输入字节本身不符合声明编码（比如声明
gbk却传入纯 ASCII），也不会报错，只是按规则解码——结果可能合法但语义错
怎么用 charset.NewReader 做安全解码
这是最常用路径：拿到原始 []byte 或 io.Reader，结合 HTTP 头或 HTML meta 提供的编码提示，构造可读的 io.Reader。
关键在顺序：先尝试从 HTTP header 解析，再 fallback 到 HTML meta，最后才用默认（如 UTF-8）。charset.NewReader 本身不解析 HTML，你得自己提取 <meta.*charset。
立即学习“go语言免费学习笔记（深入）”；
- 传入的
label用charset.Lookup校验是否支持：if _, ok := charset.Lookup(label); !ok { /* 拒绝未知编码 */ } - 不要直接对未验证的用户输入调用
NewReader，避免 panic（某些编码如"hz-gb-2312"在旧版中未实现） - 返回的 reader 是带 buffer 的，若原始数据含 BOM，
NewReader会自动跳过并覆盖 label —— 这是特性不是 bug
reader, err := charset.NewReader(bytes.NewReader(raw), "gbk")
if err != nil {
// 注意：err 只在 label 不合法时返回，不解码失败
return err
}
content, _ := io.ReadAll(reader) // 此处才真正触发解码
想真正检测编码？得换库，比如 go-runewidth 或 golang.org/x/text/encoding/unicode 不行
golang.org/x/text/encoding 系列只负责编解码，不检测；go-runewidth 是算字符宽度的，和编码无关。真要探测，目前较稳的是 github.com/saintfish/chardet（纯 Go，基于字符分布统计）或 github.com/rainycape/unidecode（轻量但仅限 Latin 衍生）。
但要注意：中文场景下，chardet 对 GBK/GB2312/Big5 的区分准确率约 70–85%，尤其短文本（
- 必须喂足够长的原始字节（建议 ≥ 512 字节），否则返回
"ascii"或"utf-8"的假阳性很高 - 检测结果是概率值，
Confidencegbk） - 和
charset.NewReader搭配用：先chardet.DetectBest得到 label，再传给charset.NewReader解码
HTTP header 和 HTML meta 冲突时以谁为准
按标准，HTTP header 优先级高于 HTML meta。但实际中，很多老网站 header 没设 charset，全靠 meta；也有 header 写错、meta 写对的情况。Go 的 charset 包不帮你做优先级决策，它只认你传进来的那个 label。
所以你要自己定策略。常见做法：有 header 就用 header；header 缺失或值为 "utf-8" 且内容明显非 UTF-8（如含 0x81–0xFE 连续双字节），再扫 HTML meta。
- HTML meta 提取别用正则全文匹配，用
golang.org/x/net/html解析 DOM 更可靠（防止注释里藏干扰字符串） - 注意
<meta http-equiv="Content-Type" content="text/html; charset=GBK">这种旧写法也要支持 - 如果 meta 里是
charset=gb2312，应主动映射为"gbk"再传给charset.NewReader，因为gb2312不在 IANA 标准 label 列表中
检测编码这件事，本质是妥协的艺术：没有银弹，只有上下文约束下的概率选择。BOM、HTTP header、HTML meta、字节分布，每条线索都可能撒谎，最终得靠你控制 fallback 链和置信阈值。
