← 术语图鉴

日志

Logging · 也叫 log / 控制台 / 构建日志 / 错误日志

程序运行时记下的流水账:什么时候、发生了什么、出了什么错。事后排查全靠它。

你可能会说:

  • “用户说页面坏了,我这边什么都看不到,怎么查?”
  • “部署失败了,平台只说"Failed",原因去哪看?”

它是什么

日志分好几种:构建日志记录部署时安装、编译的过程;服务器日志记录后端处理每个请求的情况;浏览器控制台记录前端运行时的信息。出问题时,先确认去哪一种日志里找。

日志要写得有用:带上时间、出错的位置和关键参数,但绝不能写进密钥、密码这类敏感信息。

前端的错误默认只留在访客自己的浏览器里,你永远看不到。想知道线上出过什么错,要主动把错误上报到你能看到的地方。

打个比方

像飞机的黑匣子:平时没人看,出了事第一个要找的就是它。没装黑匣子,事后只能猜。

在这个网站里

第 10 课的构建失败,靠的就是 Cloudflare 的构建日志:第一行写着构建机的 npm 和 Node 版本,最后几行指出锁文件缺了哪两个条目。而 E2E Review 的前端错误从没上报过,出了错只有访客自己的浏览器知道。

容易搞混的地方

常见误解

没看到报错,就是没出错

正确理解

可能只是错误没被记下来,或者记在了你没看的地方:访客的浏览器、平台的构建日志、被过滤掉的控制台级别。

你可以这样告诉 AI

复制下面这段,贴给你的 AI

这个项目的日志在哪里看:构建日志、服务器日志、前端错误分别去哪找?关键操作和错误有没有记下时间、位置和参数?日志里有没有可能写进密钥?前端的错误有没有上报?

接着看

  • 错误边界——包在页面外面的一层保护:里面的代码崩溃时,显示一个出错提示,而不是让整页变成空白。
  • 评测——一组带标准答案的问题:每次改提示词、换模型之后都跑一遍,用通过率判断是变好还是变坏。

在这些课里出现