📍 WDQWDWQD987AAAAA:18.97.9.175
📱 CCBot/2.0 (https://commoncrawl.org/faq/)
🔗 /98a63de02d7b.html
📄

搭建个人博客教程：结果无法复现时保留、改写还是退出

先别急着换教程。无法复现通常只有两类原因：环境差异和步骤差异。用一套可核对的对照实验，能在半小时内判断该保留、改写还是退出，而不是凭感觉重装系统。

先做一次最小对照：同一命令在两处跑

把教程里最基础的一条命令或一个操作单独拿出来，在你的环境和教程描述的环境里各跑一次，只记录输出，不修改任何配置。这一步的目的是把“环境差异”和“步骤差异”分开。

• 两处输出一致，但后续步骤失败：偏向步骤差异，问题出在教程省略的中间动作，如未说明的依赖安装、目录切换或配置重载。
• 两处输出不一致：偏向环境差异，继续核对版本号、操作系统、运行时和权限模型。
• 两处都失败：教程本身可能已过时或存在错误，此时退出比修补更省时间。

记录时只写事实：命令、完整输出、时间。不要写“感觉不对”，否则后面无法比对。

环境差异的三种可核对证据

环境差异最难察觉，因为它不报错，只是结果不同。以下三类证据可以直接核对，不需要猜测。

版本号与依赖树

用 --version 或包管理器的列表命令导出你实际安装的版本，和教程中出现的版本逐项对比。注意主版本号变化往往意味着行为改变，而补丁号变化通常不影响结果。

路径与权限

教程里的相对路径在不同工作目录下会指向不同位置。先执行打印当前目录的命令，确认你所在位置与教程假设一致。权限问题常表现为“文件存在但读不到”，而不是明确的报错。

外部服务的可达性

如果教程涉及拉取远程资源，先单独测试该资源是否可达。这里要谨慎：请求失败可能是网络、代理、服务端变更或资源已下线，不能只凭一次失败就断定教程失效。

步骤差异的判断：看教程省略了什么

步骤差异的特征是：环境完全一致，但按教程顺序执行会在某一步卡住，而补上一个教程没写的动作后就通了。常见省略项包括：修改配置后未重载服务、安装依赖后未重启终端、生成文件后未确认写入位置。

假设一个例子：教程让你改完配置文件后直接访问页面，你照做却看到旧内容。此时先确认配置文件是否被实际读取（查看进程启动参数或日志），再确认是否需要重载。如果重载后生效，说明是步骤差异；如果重载后仍无效，回到环境差异继续查。

保留、改写还是退出：三个前提

判断清楚原因后，决策才有依据。

• 保留：适用于环境差异，且你的环境可以调整到与教程一致。前提是教程的核心方法仍然成立，只是版本或路径不同。动作是记录差异清单，后续每步都按清单核对。
• 改写：适用于步骤差异，且你能补全缺失动作并验证结果。前提是你理解每一步的目的，而不是照抄。动作是把补全的步骤写进自己的笔记，标注“教程未写，实测需要”。
• 退出：适用于两处最小对照都失败，或教程依赖的服务已不可用。前提是你已排除自身环境问题。动作是保留失败记录，换一份有明确版本说明的教程，避免在同一份材料上反复投入。

把结论写进自己的核对清单

无论选择哪种处理，最后都产出一份清单：命令、预期输出、实际输出、差异归类。下一次遇到无法复现时，先查清单，而不是重新搜索教程。这份清单本身就是你从教程里真正获得的东西，比“跑通一次”更耐用。