go标准库encoding/json无法解析hjson，因其严格遵循rfc 8259，不支持注释、单引号字符串、未引号键名及尾逗号等hjson扩展特性，遇此类语法即报invalid character错误；必须使用hjson-go等第三方库。
Go 无法原生解析 HJSON，必须用第三方库；不引入 hjson-go 或等效库，encoding/json 会直接报错或静默丢弃注释/单引号/尾逗号。
为什么标准库 encoding/json 不能读 HJSON
HJSON 是 JSON 的超集，允许注释、单引号字符串、省略引号的键名、尾逗号等——这些在 JSON 规范中非法。Go 标准库的 encoding/json 严格遵循 RFC 8259，遇到 // comment 或 'value' 会立即返回 invalid character 错误。
- 典型错误：
invalid character '\'' looking for beginning of value（单引号触发） - 或：
invalid character '/' after top-level value（注释触发） - 即使文件内容“看起来能跑”，尾逗号也可能导致解析出错或字段被跳过
使用 hjson-go 库的最小可行步骤
目前最稳定、维护活跃的 Go HJSON 解析库是 github.com/hjson/hjson-go/v4（v4 是当前主流版本）。它提供与 encoding/json 类似的 API，但接受 HJSON 输入。
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 安装：
go get github.com/hjson/hjson-go/v4 - 基础解析示例：
import (
"fmt"
"os"
"github.com/hjson/hjson-go/v4"
)
func main() {
data, _ := os.ReadFile("config.hjson")
var cfg map[string]interface{}
err := hjson.Unmarshal(data, &cfg)
if err != nil {
panic(err) // 例如：hjson: parse error on line 5, column 12: unexpected token ';'
}
fmt.Printf("%+v", cfg)
}
- 注意：
hjson.Unmarshal不兼容json.Unmarshal的 tag（如json:"port"），若需结构体绑定，仍要先解到map[string]interface{}再手动赋值，或用hjson.RawMessage做中间层
与 viper 集成时的特殊处理
viper 默认不支持 HJSON。想让 viper 加载 .hjson 文件，必须显式注册解析器，且需自行处理 HJSON 解码逻辑。
- 不能只调用
viper.SetConfigType("hjson")—— 这只是告诉 viper “我打算用 hjson”，但底层没注册解析函数 - 必须手动注册：
viper.UnmarshalFunc+hjson.Unmarshal组合 - 更简单做法：先用
hjson.Unmarshal解出map[string]interface{}，再传给viper.MergeConfigMap
容易被忽略的兼容性细节
HJSON 的灵活性带来几个隐性坑：
- 未加引号的键名（如
port: 8080）在解析后变成map[string]interface{}的 key，但 Go struct tag 无法自动映射——必须用map或自定义 UnmarshalJSON 方法 - HJSON 支持多行字符串（
text: | hello\n world），hjson-go会正确转为换行符，但若下游代码假设字符串无 \n，可能出逻辑 bug - 注释本身不会进入解析结果，但若把注释写在值后面（如
timeout: 30 // seconds），hjson-go会忽略整行注释，不影响解析；但若写成timeout: 30//seconds（无空格），部分旧版解析器可能误判
真正麻烦的从来不是“能不能读”，而是“读出来的东西和你预期的 struct 是否对得上”——HJSON 的宽松语法让 schema 更模糊，建议只在配置由人工长期维护、且团队明确约定格式时使用，避免自动化流程依赖其非标准特性。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
