个人独立博客站点在写博客的时候应该注意什么？

这个问题是我对技术类个人博客写作时的纯主观见解，各位就图一乐看看，谢谢。

1.把读者当作第一次看相关技术文章

这一点其实很难做到，包括我在本站写的很多博客都并没有做到这一点。

所谓把读者当作第一次看相关技术文章，举个例子：你写了一篇部署某某docker容器的教程，那么理应在博客中涉及如何在Linux主机上安装docker的教程部分。

这个安装docker的教程部分可以直接添加至文章内，或者单独写一篇文章，把链接放在该文开头。

这样做有什么好处？除了让别人能点击链接看你的站点里面的另外一篇文章，更重要的是保证读者在看你这篇文章的时候，不需要去额外搜索其他的东西。

之前在WSL安装CENTOS8的博客中我就吐槽过这个问题。我找到的资料原文作者图文不对应，用着win11的电脑写着win10的步骤（步骤是错的），整个设置和开启的过程也没有图片，很让人无语。

对于使用windows系统比较熟练，知道怎么找设置选项的读者来说，这并不是神马大问题。但是对于很多刚入门编程学习的小白来说，图文不对只会让人感到困惑，最终还是得去搜其他资料，找怎么在win11里面开启wsl。

而原博主只需要多花30秒把那个win10的步骤改成win11的，就能节省读者去搜索另外一篇博客的时间。

同理，如果我想使用minio这个项目，发现最好的部署方式是docker部署，但我的主机上没有docker，此时我就得搜索两篇博客

  1. 如何在linux上安装docker
  2. 如何在docker里面安装minio

但实际查询资料的时候，以我个人为例，我都是先搜到第二个问题，再回过头去搜第一个问题的。如果我搜到的第二个问题的博客里面，作者引用或者介绍了如何安装docker的方式，那么我就不需要去额外搜索第一个问题了，这便是给读者节省了时间。

2.减少博客里面的图片数量

这个是根据不同类型的博客而言的， 对于很多教程类博客而言，图片/步骤截图是不可或缺的。

但是对于Linux类、代码编程类的博客而言，完全可以用代码块来替代图片。比如简单测试程序的运行结果，完全没必要截图，而是可以直接用代码块展示结果。在一些情况下可以做到整篇博客完全不需要截图。

减少图片数量的好处：

  1. 用户加载博客的时间缩短；
  2. 图床压力减少；
  3. 博客“失效”概率降低；

所谓博客失效，就是有些教程博客中的图片不见或者加载不出来了，直接导致这篇博客废掉了。如果博客中图片数量较少，对博客有效性的影响就更低，博客失效的概率也就降低了。

3.避免豆腐块

这其实是从学生阶段学到的东西，即写任何长段文字的时候都应该分点分段。

有些文章一上去整个豆腐块扒在那里，没有分段，看的巨难受。更有甚者连标点都没几个……

4.拒绝半途而废

有些博文非常奇怪啊，写到一半戛然而止，非常怀疑是爬虫没有把后半部分爬出来……

5.说清楚版本号

环境部署、程序安装等等教程的时候，一定要在博客里面写清楚你当前使用的系统的版本号，很多时候一些不兼容问题就是版本号对不上导致的。

6.写明结果

最简单的一个例子，leetcode的一篇题解博客，你应该给出leetcode通过的截图。我就遇到过题解里面思路啪啪啪一顿输出，结果最终的代码复制粘贴过去都没办法通过的。

代码没办法通过可能是leetcode更改了测试用例，也有可能是题目要求有变化。

如果你在文章里面贴了leetcode通过截图，读者就不会把问题怀疑到你身上。但如果没有，我就得吐槽一下：“怎么有人代码都没办法通过还好意思发题解的啊？”

写明结果，避免误会。有头有尾才能令人信服。

The end

暂时就想到这么多，后续能想到其他的再来补充。