调试清单：创始人的5分钟排查顺序

调试清单写给非技术创始人：刷新、控制台、登录、服务器、保存，按这个确切顺序排查，就能快速解决九成问题。再附上15分钟的深度检查和最后的终极手段。

分类Build with AI

阅读时长1 分钟

已发布2026年10月14日

作者Luis Goncalves

调试清单：出问题时，严格按这个顺序检查——刷新页面、查看控制台、确认已登录、确认应用确实在运行、确认已保存修改。这五项检查只需五分钟，就能解决90%的问题。顺序本身就是方法——大多数创始人调试时是随机乱猜，这正是他们一直卡住的原因。

调试是一项技能，不是魔法。下面是完整的清单，从五分钟的快速检查，到最后的终极手段。

调试清单第1步：5分钟快速检查（解决90%的问题）

刷新页面。它会清除临时状态并重新加载数据。如果普通刷新没用，就做强制刷新——刷新时按住Shift——这还会清除浏览器可能还在使用的上周的缓存文件。
打开控制台，找红色。浏览器的开发者控制台是错误现身的地方。红色文字就是错误，信息里通常会指出文件和行号。如果它读起来像天书，如何读懂错误信息会帮你解码其中的规律。
你登录了吗？大多数功能都需要身份验证，而会话会悄悄过期。看看页头里有没有你的用户信息；拿不准就退出再重新登录。数量惊人的“坏掉”的功能，其实只是登录过期了。
应用真的在运行吗？如果你在本地工作，看看终端——你的开发服务器应该在打印日志。如果它崩溃了或根本没启动，什么都不会起作用，盯着代码看再久也修不好。
你保存文件了吗？未保存的修改不会运行。看看编辑器里文件名旁边有没有那个小圆点。是的，这一条人人都会中招。

大多数bug就是这么简单：没登录、忘了保存、服务器没运行、拼写错误、忘了刷新。先从简单的东西查起——这并不低你一等，这是统计学。

如果快速检查没找到问题，就往下深入一层——仍然按顺序，仍然一次只查一件事：

清除浏览器缓存。旧的缓存文件可能与新代码冲突。强制刷新通常就够了。
打开“网络”标签页。在同一个开发者工具里，“网络”标签页会显示你的应用发出的每个请求。刷新页面，找红色的行——失败的请求——并读一读它们的状态码（见下表）。
你的数据库改动真的生效了吗？如果你最近改动过数据库结构，要确认改动已经执行——缺失的表或列会让所有碰到它的东西出错。到你的数据库控制台里看看你期待的那张表在不在。
检查你的设置文件。应用从环境文件里读取密钥和地址。缺值、密钥写错或多出空格，都会让一切出错——而且改完之后，必须重启应用，它才会察觉。
怀疑你最近的一次改动。如果一小时前还能用，那么此后你改过的任何东西都是头号嫌疑人。暂时撤销或注释掉最新的改动，看看问题是否消失。

这四行把浏览器里最吓人的标签页变成了一位分诊护士：它们告诉你，问题出在你的会话、你的地址，还是你的代码。

当别的办法都不奏效时，还有开发者版的“关了再开”：停止应用，删除已安装的依赖，重新全新安装，清除浏览器缓存，然后重启。听起来很粗暴，但它能稳定地修复损坏的安装、过时的依赖，以及那类令人抓狂的“在朋友电脑上能用，在我的上不行”的问题。

把它留到最后用，而不是最先用——因为它在修好问题的同时不会告诉你哪里出了错，下次你照样会卡住。

一次只改一件事。如果你改了五样东西然后它好了，你不知道是什么修好了它——也就意味着你同样不知道是什么弄坏了它。

每改一次就测一次。别把修复堆在一起。改一处，检查，再继续。

记录什么起了作用。同样的bug会反复出现。一份“症状 → 解决办法”的笔记文件，一个月内就会变成你最快的调试工具。

当清单用完仍无结果时：要有意识地升级求助，而不是慌乱地求助。用AI调试提示词把错误交给你的AI助手，或者按照如何寻求技术帮助来写一份规范的bug报告。到那时，你已经能回答你当时在做什么、你期待什么、发生了什么、你试过什么——而这正是清单刚刚让你收集齐的东西。

先刷新页面，再看控制台。这两步用不了一分钟，就能自行解决很大一部分问题。然后确认你已登录、应用在运行、修改已保存。只有做完这五项之后，才应该开始读代码。

因为随机乱猜会同时改动好几样东西，你永远学不到究竟哪里出了错。固定的顺序先测试最可能、检查成本最低的原因，并逐一排除——平均而言更快，还附赠一个好处：让你了解自己系统的故障规律。

按可能性排序：你没保存文件，应用没在运行，浏览器显示的是缓存版本（强制刷新），或者你编辑的文件不是应用正在使用的那个。这四项都是两分钟的检查，合起来几乎涵盖了所有情况。

在快速检查和深度检查之后——大约20分钟的系统性工作。到那时，你已经能说清你当时在做什么、期待什么、发生了什么、确切的错误信息，以及你试过什么。这就是一份好的求助请求所需的一切，无论你问的是AI还是真人。

继续阅读

完成职场窒息指数——这项免费测评告诉你是否已准备好成为独立创业者。