打印高质量日志的10条军规

日志是系统的眼睛，记录着代码的一举一动。好的日志能让人一眼看穿问题，糟糕的日志比乱麻还让人头疼。

内容精准，别打马虎眼
别写“出错了”这种废话。错误类型、相关参数、堆栈信息，一个都不能少。日志不是猜谜游戏，含糊其辞只会耽误事儿。

分级明确，轻重有别
DEBUG、INFO、WARN、ERROR各司其职。流水账似的全记成INFO，关键时刻找不着北。该报警的别藏着，鸡毛蒜皮的事也别刷屏。

带上上下文，别当孤魂野鬼
光秃秃的“用户登录失败”不如“用户[张三]因密码错误登录失败（设备：iOS 15，IP：192.168.1.1）”。线索越多，破案越快。

时间戳精确到毫秒
“下午三点”这种说法在分布式系统里就是耍流氓。多线程高并发场景下，毫秒级时间戳才能理清事件顺序。

避免敏感信息裸奔
密码、密钥、身份证号别往日志里塞。安全审计不过关，小心吃不了兜着走。

统一格式，别玩花样
JSON也好，文本也罢，团队必须用同一套模板。今天换格式明天改字段，查日志得配八副眼镜。

控制体积，别把硬盘撑爆
循环调用里写DEBUG日志，分分钟让服务器跪着喊娘。日志轮转和自动清理必须安排上。

异步写入，别拖慢正事
同步写日志导致请求超时，典型的捡芝麻丢西瓜。日志再重要也拼不过核心业务。

关键操作留痕，别留糊涂账
支付成功、权限变更这类操作必须白纸黑字记清楚。事后对账两眼一抹黑，财务能拎着菜刀找你。

定期复盘，别一埋了之
错误日志天天报却没人管，等于在系统里埋地雷。每周翻翻日志，该修修该改改。

好日志像老中医的病例本，望闻问切样样齐全。烂日志像天书，神仙看了都摇头。