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

搭建个人博客教程，学习工具时应该记录什么

学习搭建个人博客时，最该记录的不是每一步的截图，而是三类信息：你用的工具与版本、你做的关键选择及理由、以及出问题时能复现的现象。这样记录，下次换主题、换电脑或隔几周再回来，你能快速接上，而不是从头再查一遍。

先明确：记录的目标是能复现，不是能背诵

搭建个人博客涉及的工具通常包括静态站点生成器、代码编辑器、版本管理工具和部署方式。初学时很容易陷入“跟着做一遍就会了”的错觉，但真正卡住人的往往是环境差异和配置细节。所以记录的第一原则是：让别人（或未来的你）只看笔记就能复现出同样的结果。

如果只是自己练手、不打算长期维护，记录可以简化为关键命令和配置文件位置；如果打算持续更新博客，记录就要更完整，尤其是版本号和自定义改动。

必须记录的四类内容

• 工具与版本：例如生成器名称、运行环境版本、依赖包版本。版本不同，命令和配置项可能不一样。
• 关键选择：为什么选这个主题、为什么用这种目录结构、为什么改了这个配置。理由比操作更重要。
• 可复现的现象：报错时记录完整提示、你执行的那条命令、以及当时的目录位置。
• 验证方式：怎么确认这一步成功了，比如本地预览能看到什么、生成的文件出现在哪个目录。

具体怎么记：一个可执行的最小模板

不需要复杂工具，一个 Markdown 文件就够。按下面结构写，每完成一步就补一条：

1. 目标：这一步想达到什么效果。
2. 命令或操作：实际输入的内容。
3. 结果：成功信号是什么，失败时原样贴出提示。
4. 备注：踩过的坑、临时改动、待确认的疑问。

例如记录安装依赖这一步时，写成“执行安装命令后，依赖目录出现且无报错”，比只写“安装成功”有用得多。假设你后来换了一台电脑，看到这条记录就知道要检查依赖目录是否存在，而不是凭记忆猜测。

哪些内容不必记

界面截图、可以一键复制的默认配置、以及官方文档已经写清楚的通用说明，通常不需要逐字抄。记录的重点是你自己做的决定和遇到的意外，而不是搬运文档。判断标准很简单：如果这条信息在任何一台新机器上都能从官方文档查到，就不必记；如果它只对你这套环境成立，就值得记。

验收信号：怎么知道记录得够用

隔一周后，只看自己的记录，能否在不搜索的情况下完成以下动作：找到配置文件、改一个站点标题、重新生成并本地预览。如果能，说明记录合格；如果某一步必须回去翻聊天记录或浏览器历史，说明那一处缺了关键信息，补上即可。

下一步建议：现在就打开你正在用的笔记工具，为当前这次搭建建一个文件，先写下工具名称和版本，再补上你今天做过的第一个关键选择。之后每完成一步就追加一条，不用追求一次写全。