logrus.WithFields要求key必须为string，非字符串key会导致panic；SetLevel需配合SetOutput使用，否则可能静默丢日志；DisableColors与ForceColors不可同时设置；WithError保留error原始信息，优于直接传err。
logrus.WithFields 传 map[string]interface{} 时 key 必须是 string
logrus 不接受非字符串类型的 key，比如 int、bool 或结构体字段名直接当 key（如 user.ID），否则 panic：panic: reflect: call of reflect.Value.Type on zero Value。
常见错误是把 struct 直接塞进 logrus.Fields，误以为会自动展开字段名：
log.WithFields(logrus.Fields{user: user}).Info("user info") // ❌ user 是变量名，不是字符串 key
正确做法是显式写出字段名和值：
- 用
map[string]interface{}手动构造，key 全是string - 避免用
fmt.Sprintf拼 key，容易漏引号或类型错位 - 如果要打 struct 全字段，先用
json.Marshal转成字符串再塞进去，别强求自动反射
logrus.SetLevel 后日志不输出？检查是否调用了 SetOutput
logrus 默认只输出到 os.Stderr，但如果你改过 SetOutput（比如重定向到文件或 ioutil.Discard），又没同步处理 level，就会“静默丢日志”——没报错，也没输出。
立即学习“go语言免费学习笔记（深入）”；
典型场景：测试环境想关掉 debug 日志，只保留 error，结果发现 info 也不见了：
log.SetLevel(logrus.ErrorLevel) log.SetOutput(ioutil.Discard) // ❌ 这行让所有日志都丢了，和 level 无关
解决方法很简单：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
SetOutput和SetLevel是两个独立开关，必须都配对检查 - 调试时加一句
log.Out == os.Stderr判断输出目标是否正常 - 生产环境写文件时，记得用
os.OpenFile带os.O_APPEND | os.O_CREATE，否则可能因权限或路径问题导致Write失败而静默丢日志
logrus.TextFormatter 的 DisableColors 和 ForceColors 冲突吗？
会。如果终端不支持颜色（比如 CI 环境或重定向到文件），DisableColors: true 生效；但一旦设了 ForceColors: true，logrus 就强行加 ANSI 转义符，不管终端能不能渲染。
后果是：日志文件里出现一堆 \x1b[36m 类乱码，或者某些日志系统解析失败。
建议按场景选：
- 本地开发：留空，靠自动检测
- CI/CD 流水线：显式设
DisableColors: true，别碰ForceColors - 强制彩色（如 k8s pod 日志看板）：只设
ForceColors: true，且确保下游能解码 - 别同时设两者，logrus 不校验，但行为不可控
logrus.WithError(err) 和 log.Error(err) 有什么区别？
WithError 是给日志加一个叫 error 的 field，类型是 error，最终序列化时会调用 err.Error()；而 log.Error(err) 是把 err 当作普通参数传给 Sprintf，等价于 log.Error(err.Error()) —— 它丢失了原始 error 类型信息，比如 stack trace、wrapped error 都没了。
更关键的是：很多 logrus hook（比如 sentry、elastic）只认 WithError 注入的 error 字段，才能自动提取堆栈和上下文。
- 用
log.WithError(err).Warn("failed to fetch user")✅ - 别用
log.Warn(err)或log.Warn(err.Error())❌ - 如果 err 是 nil，
WithError(nil)会忽略，安全；但log.Error(nil)会打出<nil>字符串，污染日志
字段名固定是 error，不能改；想加多个 error？只能自己命名，比如 db_error、http_error。
