应初始化线程安全的 logrus 实例：var log = logrus.New()，避免使用全局 logrus. 函数以防配置冲突；设置输出用 log.SetOutput()；高频日志复用 WithFields 封装的 entry；需 caller 信息时用专用 hook 并验证 CPU 开销；生产环境强制 JSONFormatter 以适配日志采集系统。
怎么初始化一个线程安全的 logrus 实例
直接用 logrus.New()，别碰全局 logrus. 前缀的函数（比如 logrus.Info()），除非你明确接受它带来的隐式共享和配置冲突风险。
全局 logger 是单例，所有包修改 logrus.SetLevel() 或 logrus.SetFormatter() 都会互相覆盖——尤其在多模块、多依赖的项目里，A 包切了 JSON 格式，B 包又切回文本，日志就乱套了。
- 每个模块或服务建议创建自己的
log变量：var log = logrus.New() - 设置输出目标时，优先用
log.SetOutput()而非直接赋值log.Out（后者不触发内部 hook 初始化） - 如果要用文件输出，记得加
os.O_APPEND和错误检查，否则可能静默丢日志
怎么加字段（Fields）才不拖慢性能
WithField() 和 WithFields() 看似方便，但每次调用都会新建 *logrus.Entry，高频日志（如请求日志）下 GC 压力明显。真正需要结构化上下文的地方才加，别无脑塞 user_id、req_id 进每条 info 日志。
- 高频路径（如 HTTP 中间件）用
log.WithFields(log.Fields{"req_id": id, "path": r.URL.Path})一次封装，后续复用该 entry - 避免链式嵌套：不要写
log.WithField("a",1).WithField("b",2).WithField("c",3).Info(...)，改用WithFields()一次性传 map - 字段值尽量用基础类型（string/int/bool），避免传 struct 或指针——logrus 会深拷贝，还可能 panic
为什么日志里没有文件名和行号
logrus 默认不记录 file:line，这不是 bug，是设计取舍：开销可控、避免 runtime.Callers 性能抖动。但线上排障时缺这个信息真的很痛苦。
立即学习“go语言免费学习笔记（深入）”；
官方没合入相关 PR（issue #63 从 2014 年 open 到现在），所以得自己补：
- 用第三方 hook 如
logrus/hooks/hostname不行，得找专做 caller 的，比如github.com/sirupsen/logrus/hooks/caller（注意版本兼容性） - 手动加也行，但 skip 层级要试：通常设
skip=6~8才能跳过 logrus 内部调用栈，落到你的业务代码行；设小了报错，设大了拿到的是runtime.goexit - 开启后留意 CPU 占用——高 QPS 场景下，caller 获取可能吃掉 5%+ CPU，压测时务必验证
JSON 格式 vs Text 格式怎么选
本地开发用 TextFormatter，上生产必须切 JSONFormatter。不是因为“高级”，而是日志采集系统（Filebeat / Fluent Bit）几乎只认 JSON 字段做解析和路由。
-
JSONFormatter默认把msg当字符串，不会自动展开 map；想让结构体字段扁平进 JSON，得自己实现Formatter或预处理字段 -
TextFormatter的FullTimestamp:true很实用，但注意它输出的是本地时区时间，K8s 容器里常是 UTC，排查跨时区问题容易误判 - 别混用：同一进程里切来切去会导致 hook 行为异常，比如某个 hook 只监听 JSON 输出事件
最麻烦的其实是日志生命周期管理——比如 hook 写文件失败要不要重试、JSON 序列化 panic 了会不会吞掉整条日志、hook 里调用网络服务卡住主线程……这些不在文档首页，但上线后第一个凌晨报警电话往往就来自这儿。
