configor.Load() 加载失败主因是路径不固定或文件含BOM头，应转绝对路径并校验BOM；struct需显式加json/mapstructure tag；环境变量覆盖需匹配前缀和下划线分隔规则；热重载须自行校验、原子切换与错误回退。
configor.Load() 加载失败的常见原因
直接调用 configor.Load() 报错，多数不是配置语法问题，而是路径或权限没兜住：文件路径是相对路径但当前工作目录不固定（比如 systemd 启动时），os.Stat 返回 “no such file” 却没打日志；或者文件有 BOM 头，解析器卡在首行乱码上静默失败。
建议做法：
- 加载前先用
filepath.Abs()转成绝对路径，再传给configor.Load() - 手动读一次文件：
content, _ := os.ReadFile(path)，检查前 3 字节是否为[]byte{0xEF, 0xBB, 0xBF}，是就bytes.TrimPrefix(content, bom) - 错误日志里补一句
os.Stat(path)结果，确认是否存在、是否可读
struct tag 必须用 json 或 mapstructure，不能只靠字段名
configor 默认按字段名匹配 key，但大小写敏感且不处理嵌套别名。比如 YAML 里写 db_host: localhost，结构体字段叫 DBHost 就读不到——它不会自动转 snake_case。
正确写法是显式加 tag：
立即学习“go语言免费学习笔记（深入）”；
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
type Config struct {
Database struct {
Host string `json:"db_host" mapstructure:"db_host"`
Port int `json:"port" mapstructure:"port"`
} `json:"database" mapstructure:"database"`
}
- 必须同时写
json和mapstructure：前者用于 JSON 解析，后者用于 YAML/TOML - 嵌套结构体也要加外层 tag，否则
database这一级会丢失 - 别依赖
configor的“自动推导”，它不处理下划线/驼峰转换
环境变量覆盖失效？检查前缀和分隔符
configor 支持 APP_DATABASE_HOST=127.0.0.1 覆盖配置，但默认前缀是 CONFIGOR，不是 APP；而且下划线 _ 是层级分隔符，不是字段名一部分。
例如想覆盖 redis.addr，环境变量得写成 CONFIGOR_REDIS_ADDR=127.0.0.1，而不是 CONFIGOR_REDIS_ADDR 或 CONFIGOR_REDIS_ADDR。
- 初始化时显式指定前缀：
configor.New(&Config{}, configor.WithEnvPrefix("APP")) - 多级嵌套字段名中所有
_都会被当成分隔符，APP_CACHE_TTL_SECONDS→cache.ttl_seconds，不是cache_ttl_seconds - 如果值含空格或特殊字符，必须用引号包裹环境变量：
APP_LOG_LEVEL="debug info"
热重载不可靠，别信 configor.Watch() 的默认行为
configor 的 Watch() 底层用 fsnotify 监听文件变化，但它不校验新内容是否合法：配置改错格式后触发 reload，程序可能 panic 或静默使用旧值，且没有回滚机制。
生产环境真正可用的热重载必须自己封装：
- 监听到变更后，先用
configor.New()创建新实例解析文件，成功才替换旧实例 - 替换时用
sync.RWMutex控制写入，读配置的函数（如GetDBHost()）只读不写 - 失败时保留旧配置，并记录完整错误（包括哪一行、什么类型错误），不能只打 “reload failed”
- 编辑器保存常触发多次事件，加 channel 做防抖，比如 500ms 内只执行最后一次 reload
configor 本身不提供原子切换或失败回退，这些都得业务代码兜底——它只是个解析器，不是配置管理平台。
