logging-conventions

日志记录和可观测性规范（宽松的调试日志、结构化的键值字段、基于级别的详细程度控制、标准日志库）。适用于所有语言和运行时环境。触发条件：编写或编辑涉及 I/O 或外部调用的代码，包含非平凡决策分支，或执行长时间/多步骤操作；设置或配置日志库/订阅者；添加诊断信息或替换 `print`/`println`/`echo`/`console.log`；用户询问关于日志、日志级别、结构化日志、详细程度或本仓库的可观测性相关问题。跳过条件：更改是琐碎的且无值得记录的行为（纯格式化、注释、仅配置修改），且用户未询问日志相关事项。

模型生成摘要（rules/v1 · 2026-11-14 03:27）：日志记录和可观测性规范（宽松的调试日志、结构化的键值字段、基于级别的详细程度控制、标准日志库）
这是模型对公开材料的总结，不是官方声明，请以原链内容为准。

存档时间线

版本	存档时间	内容哈希	内容
v1	2026-11-14 03:26	d0f60477	可取

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

纠错与举报（发现条目失效、署名有误或涉及侵权？）

提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。