📄 一句话概括
卡住时先认症状、再查原因:十个问题里有八个不是安装的事;反复重装是最贵的排查方式。
📝 本节和前面几节的关系
上一节是开工前的体检,这一节是开工后的对症下药。
一、先认症状,别急着重装
排查的第一原则:先分清是哪一类问题。命令找不到、答非所问、乱改文件、太慢太贵——这四类的解法完全不一样。 十个问题里大概有八个不是安装的问题。上来就重装,等于用最贵的方式处理最简单的病。
二、四类症状,四套解法
敲命令说找不到:装好了但没生效。重开终端;查 PATH 里有没有它。 答非所问:需求没给全。补范围、补【不要什么】,别急着重复问。 乱改文件:约束没写死。先让它列计划,你同意后再动手。 太慢或太贵:一次给了太多。把活切小,一次只做一块。
三、还有一类最隐蔽的:做完了但不对
它不报错、也不慢,就是结果不对。原因通常是验收标准没定。 修法是回到第 2.6 节:把【做完怎么算对】这句话补上。 这是新手最容易漏的一类,因为它看起来像【它能力不行】,其实是需求没写完。
四、排查的纪律
一次只改一处。同时改两处,下次就不知道是哪一处起了作用。 记录你的坑。记一句话就够:症状是什么、根因是什么、怎么解决。 本章末尾的练习里就有这一条——踩过的坑不记下来,下次还会原样再踩一遍。
五、动手 Demo:卡住了怎么办——按症状排查
下面把六类常见症状按【多半是什么原因—先试这个】排成表。
rows = [("敲命令说找不到", "装好了但没生效", "重开终端;查 PATH"),
("一上来就报错退出", "环境不完整", "按提示缺什么补什么"),
("答非所问", "需求没给全", "补范围、补不要什么"),
("乱改文件", "约束没写死", "先让它列计划,同意再动手"),
("太慢或太贵", "一次给了太多", "把活切小,一次做一块"),
("做完不对", "验收标准没定", "先说清怎么算做对了")]
实跑输出:
--------------------------------------------------------------------
卡住了怎么办——按症状排查
--------------------------------------------------------------------
症状 多半是 先试这个
---------------------------------------------------------------------
敲命令说找不到 装好了但没生效 重开终端;查 PATH 里有没有它
一上来就报错退出 环境不完整 按它提示的缺什么补什么
答非所问 需求没给全 补范围、补不要什么
乱改文件 约束没写死 先让它列计划,同意后再动手
太慢或太贵 一次给了太多 把活切小,一次只做一块
做完不对 验收标准没定 先说清怎么算做对了
这张表的用法:**先认症状,再查原因**。别一卡住就重装,十次里有八次不是安装的问题。
最后一行值得单独记住:做完不对不是它笨,是你没定义什么叫对。 这张表的用法是先认症状、再查原因——别一卡住就重装。
30 秒实验
- 把上面六类症状抄在便签上,贴在终端旁边。
- 回想最近一次卡住,你当时是怎么解决的?记进你的备忘,这就是本章最后一节要的练习。
常见误区
- 卡住就重装。重装会掩盖真正的原因,让同一个问题下次再来一遍。
- 同时改好几处。一次只改一处,才知道是哪一处起了作用。
自测三问(点开对答案)
1. 排查时最先该做什么? —— 先认症状分类,别急着重装——大部分问题不是安装引起的。 2. 【做完不对】多半是什么原因? —— 验收标准没定:你没说明什么叫做对了。 3. 为什么一次只改一处? —— 同时改多处就失去了参照,下次不知道是哪一处起了作用。- ☐ 下一节(2.9 本章练习)
相关笔记
- 🐳 DeepSeek Harness技术架构原理 · 索引 — 工具链出问题时怎么定位
- 🧡 Claude Code橙皮书 · 索引