30天学会AI工程师｜Day 23：AI 项目最怕的不是报错，而是你根本不知道它错在哪里

你先知道一件事

很多新手写程序，出了问题第一反应就是反复打印，哪里不对就临时加一句输出。这样在最开始当然能凑合，但一旦系统稍微复杂一点，调试就会变得非常痛苦。

为什么这一步重要

AI 项目尤其如此。

因为问题来源太多了。可能是 Prompt 设计不清楚，可能是模型输出格式变了，可能是工具调用参数不对，也可能是检索结果本身就不相关。你如果没有日志，很多时候只能靠猜。

至少要记录什么输入进来了，调用了什么模型，发出去的大致 Prompt 是什么，返回了什么结果，是否触发了工具，工具执行是否成功。

一旦这些关键节点被保留下来，你排查问题的速度会快很多。

很多人会觉得日志好像是“后面再说”的事情，但现实恰恰相反。越早建立最小日志习惯，后面越省时间。因为 AI 应用的问题本来就带着不确定性，你如果什么都不留，只会一遍遍重跑，然后越来越糊涂。

常见误区

今天这一节的核心，不是学多复杂的监控系统，而是建立一个最小调试意识。

今天要做的 3 件事

• 今天建议你做最小版本就好。哪怕只是把关键步骤打印得更有结构，或者把每次调用结果写进一个文本文件，价值都比完全裸奔强。
• 你也可以顺手记录几个最常见的错误场景，比如接口失败、格式解析失败、工具参数缺失、检索内容为空。只要这些情况能被你看见，就不算白做。

今天的最低产出

• 让你的小项目具备最基本的日志或调试输出，至少能帮助未来的你快速回看一次调用过程。

一句提醒

当你开始重视日志，说明你已经不满足于“偶尔跑通”，而是在往“能定位问题、能持续改进”的方向走。