出问题时,日志是救命稻草。但日志太少查不到、太多又淹没重点。Claude Code能帮你设计合理的日志策略，下面就分享Claude Code怎么写好日志的详细方法。
好日志的价值
- 快速定位线上问题
- 还原问题发生时的现场
- 监控系统运行状态
- 审计关键操作
用法一:添加合理日志
「为这个关键流程加上合适的日志,记录入参、结果和异常。」
用法二:结构化日志
「把日志改成结构化(JSON)格式,便于检索和分析。」
用法三:日志分级
「帮我合理使用 debug/info/warn/error 级别,别一律 info。」
用法四:脱敏处理
「日志里有手机号和密码,帮我脱敏,别记录敏感信息。」
日志绝不能记录密码、密钥等敏感信息。
用法五:统一日志规范
把日志规范写进 CLAUDE.md,团队记录方式一致。
日志记录实践建议
- 分级使用:别什么都 info,关键才 error。
- 结构化:便于检索、聚合、告警。
- 记关键信息:入参、关键节点、异常。
- 脱敏:敏感数据绝不入日志。
- 适度:别刷屏,也别太少。
日志级别速查
| 级别 | 用于 |
|---|---|
| debug | 调试细节 |
| info | 正常关键流程 |
| warn | 可恢复的异常 |
| error | 需关注的错误 |
小结
把日志设计交给 Claude Code,分级、结构化、记关键信息、脱敏,线上问题有据可查。日志写得好,排查快一半。