你先知道一件事很多新手写程序出了问题第一反应就是反复打印哪里不对就临时加一句输出。这样在最开始当然能凑合但一旦系统稍微复杂一点调试就会变得非常痛苦。为什么这一步重要AI 项目尤其如此。因为问题来源太多了。可能是 Prompt 设计不清楚可能是模型输出格式变了可能是工具调用参数不对也可能是检索结果本身就不相关。你如果没有日志很多时候只能靠猜。至少要记录什么输入进来了调用了什么模型发出去的大致 Prompt 是什么返回了什么结果是否触发了工具工具执行是否成功。一旦这些关键节点被保留下来你排查问题的速度会快很多。很多人会觉得日志好像是“后面再说”的事情但现实恰恰相反。越早建立最小日志习惯后面越省时间。因为 AI 应用的问题本来就带着不确定性你如果什么都不留只会一遍遍重跑然后越来越糊涂。常见误区今天这一节的核心不是学多复杂的监控系统而是建立一个最小调试意识。今天要做的 3 件事今天建议你做最小版本就好。哪怕只是把关键步骤打印得更有结构或者把每次调用结果写进一个文本文件价值都比完全裸奔强。你也可以顺手记录几个最常见的错误场景比如接口失败、格式解析失败、工具参数缺失、检索内容为空。只要这些情况能被你看见就不算白做。今天的最低产出让你的小项目具备最基本的日志或调试输出至少能帮助未来的你快速回看一次调用过程。一句提醒当你开始重视日志说明你已经不满足于“偶尔跑通”而是在往“能定位问题、能持续改进”的方向走。