我个人关于技术博客的看法

2018-09-12 17:07:29 +08:00
 mathzhaoliang

现在程序员都流行折腾技术博客,一方面是因为写作的过程可以让自己更深入的理解所写的主题,另一方面我想也有推销自己的原因,让别人更清楚的了解自己的技术能力,找到志同道合者,或者在求职中获得加分项。

我来 v2 差不多一年多了,据我观察,在 v2 上发博客链接的不计其数,写博客框架的每隔三两天也总会冒出一个。我点击去看过的有不少,但是至今没有遇到一个高质量的博客。大部分博客里的技术文章无非这几种类型:

  1. xx 环境下 xx 工具配置 或者 开发 xx 时的注意事项.
  2. 用 xx 框架 /库自己造的小轮子.
  3. Leetcode/面试 xx 题目解答. (然后贴了一堆代码)
  4. 同事的代码真坑,我费了半天劲重写了 (好厉害)

老实说,这些文章对个人成长帮助不大,而且随着时间贬值的非常快。

我从 09 年开始写博客,博客园,csdn,点点,百度空间,网易博客,博客大巴,自建 wordpress,github pages 全用过,积攒了几百篇文章,现在回头看看大部分都不满意,发现自己的理解还是不够到位,又打回草稿里。目前博客里面放着的也就十余篇。

我心目中一篇合格技术文章的标准:

  1. 首先这是一篇既给自己,也给别人看的文章。语言通顺,逻辑连贯,长文章要适当分层次,有必要的背景介绍。
  2. 有自己的思考 /实践 /理解,有闪光点。那些写小爬虫 /小博客框架的朋友,建议你们开门见山点名你的小轮子牛逼在哪里。不然的话类似的程序网上一抓一大把,别人为什么花时间看你的文章?面试官如何知道你的程序是原创的而不是从哪里山寨的?
  3. 避免写那些别人写滥了的东西(图像转字符画,验证码破解,模拟登陆 ...)
  4. 如果有走心的插图更佳。

我自己写作的标准除以上外,还有:

  1. 只写自己确定懂的,一知半解的东西先放在草稿里,什么时候搞懂了再修改好发布。
  2. 把每一篇文章当成自己在给别人讲课,起转承合都不能少。每句话是否严谨得当都要推敲。
  3. 自己动手认真配插图 /视频。
  4. 只推销自己写的程序,而且只推销自己原创的程序,即别人写不了 /没写过的。
  5. 只写网上没有 /很少有的内容,或者别人写过但是我写的更好。
  6. 不写小白文和灌水文。

一些我觉得不错的博客:

matrix67.com 是不错的博客,不过貌似停了。

阮一峰的博客也不错。以我个人而言我不会去写他那种科普文,但是必须承认他的文章写的很走心。懂行的人看了也不会觉得幼稚。

1139 次点击
所在节点    问与答
2 条回复
agagega
2018-09-14 19:25:23 +08:00
我觉得做博客首要的就是不能抄袭。转载、引用、点评、致敬都好,但是当年在 Google 上搜一个问题在 CSDN 和其他网站上出现一堆一模一样的文章,这实在太可怕了。有些我看到的博客内容太浅,浅到像话还没说完就停止了。

另外很多人把博客当作笔记,好像 V2EX 上很多朋友还比较认同这种事。当然博客是自己的,干啥都是自己的自由,就像我在程序员论坛介绍我的博客并不妨碍我可以天天写社会话题一样。我只是觉得因为每个人的思维结构和知识盲区都不一样,笔记属于个人化结构化的知识,给其他人看可能没那么有用。而且,我看到的很多这类笔记式博客自己也没有写完,很难坚持。

很多人很难把博客做好的另一个原因就是写作实在是太费时间了,尤其是想要再严谨一些的话。没有发自内心的强烈表达欲,强行写出来的文字也是干涩的。(当然,表达欲太强烈了也不好,就像我在 V 站这个地方也经常发数百字的回复一样,哈哈)
mathzhaoliang
2018-09-14 20:52:06 +08:00
@agagega 写笔记是可以的,不用介意是不是会让很多人看懂。因为有深度的技术文本来就不是给大多数人看的,有一两个同道中人就好了。光想着写短平快的文章意义不大。

但我个人写文章会尽量用有趣的、启发式的问题来引出正文内容。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/488624

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX