📍 WDQWDWQD987AAAAA:216.73.217.142
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /e2857bf8f911.html
📄

搭建个人博客教程：怎样检查练习结果，才算真正跑通

检查搭建个人博客教程的练习结果，核心不是看页面“像不像博客”，而是逐项验证四件事：本地能否正常生成、页面能否被浏览器打开、文章链接能否互跳、发布后外部能否访问。只要有一项失败，就说明练习还没跑通，需要回到对应环节定位。

先明确检查的起点：你到底练到了哪一步

搭建个人博客通常分成本地生成、本地预览、发布上线三个阶段。检查前先确认自己停在哪个阶段，否则容易把“本地没装好”误判成“服务器有问题”。可以按下面的顺序自查：

• 本地生成：运行构建命令后，输出目录里是否出现了 HTML 文件。
• 本地预览：用本地服务器打开页面，首页和文章页是否都能显示。
• 发布上线：把生成结果传到托管平台后，用另一个网络环境访问域名是否成功。

如果第一步就没通过，后面的检查都没有意义。先让本地生成成功，再谈发布。

观察：打开页面时应该看到什么

启动本地预览后，逐项观察以下现象，任何一项异常都对应具体问题：

• 首页能打开，标题、导航、文章列表正常显示，没有大片空白。
• 点进任意一篇练习文章，正文、日期、标签正常渲染。
• 浏览器地址栏的路径与文章文件名或配置的链接规则一致。
• 刷新文章页不会出现 404。
• 浏览器控制台没有持续报错。

如果首页正常但文章页 404，多半是链接规则或文件路径配置问题，而不是内容没写。如果页面样式全丢，优先检查静态资源路径是否为绝对路径、是否指向了错误目录。

判断：区分“可能原因”和“已经定位的原因”

同一现象往往有多种解释，不要看到报错就认定是某一个原因。可以用排除法缩小范围：

1. 换一个浏览器或无痕窗口再打开。若恢复正常，可能是缓存或插件干扰。
2. 查看构建命令的终端输出。若有明确报错行，按报错指向的文件修改。
3. 手动打开输出目录里的 HTML 文件。若直接打开正常、通过本地服务器异常，问题多在服务器配置或路径。
4. 把文章标题改成纯英文再试。若恢复正常，可能是文件名编码或链接生成规则的问题。

只有经过上述对比后仍然复现的现象，才能算“已经定位的原因”。在此之前，把它当作待验证的假设。

处理：按失败类型做最小修改

定位后只改一处，再重新验证，避免一次改多个地方导致无法判断哪一步生效。

• 构建失败：检查配置文件语法，尤其是缩进、冒号和引号。可以先用一篇最简单的文章测试。
• 页面 404：核对文章文件是否放在正确的内容目录，文件名与链接是否一致。
• 样式丢失：检查资源引用路径，确认生成目录中存在对应的 CSS 文件。
• 发布后打不开：确认托管平台部署的是生成后的静态文件，而不是源文件目录。

例如，假设你写了一篇名为“第一篇练习”的文章，本地预览时链接变成一串乱码路径，那么可以先把它重命名为英文文件名再构建。如果链接恢复正常，说明问题出在文件名处理环节，而不是模板本身。

复查：用一份固定清单确认练习完成

修改后重新走一遍完整流程，并逐项打勾：

1. 删除旧的生成目录，重新运行构建命令，确认无报错。
2. 启动本地预览，依次打开首页、文章列表页、至少两篇文章页。
3. 点击导航和文章间的链接，确认跳转正确、无死链。
4. 发布到托管平台，用手机流量网络访问一次首页和一篇文章页。
5. 修改一篇文章的内容，重新构建并发布，确认线上内容同步更新。

五项全部通过，才算这次练习真正跑通。若某项失败，回到对应阶段重做，不要跳过。

下一步，挑一篇你已经写好的练习文章，按上面的清单完整走一遍；把失败的那一项记下来，只针对它查资料和修改，直到五项全部通过。