怎么写一篇技术笔记

为什么要写笔记

  为什么做笔记，从我们开始上学开始就开始做各种不同笔记，好记性不如烂笔头，做笔记的第一个目的好像就是为了抵抗遗忘。根据艾宾浩斯遗忘曲线，记忆是不断的流逝。只有不定时去补偿记忆，才能能够减缓遗忘的速度；
  做笔记也是一个对知识点的一个归纳与总结的过程，在这个过程中，会对知识点反复的思考和锤炼，力求做到正确准确，不误导自己，也不误导别人的目的；
  网上的资料俯拾皆是，针对某一个问题，不同时间点不同技术版本给出了不同的解决方案，每次遇到问题，总是不能快速找到一个准确正确的解题方案，最痛苦的是别人结帖时说已经解决，但是没有给出解决方案；做笔记一方面是把自己的能够执行的框架程序或者可以解决问题的思路整理出来留作资料备份记录以便以后不时查看；另一方面是吃水不忘挖井人，给后来者留下一份能够少走弯路的资料，有过在网上寻找问题解决方案的人都懂得能够拿到一份可以执行且没有错误的示例是多么的令人欣喜；

笔记的有效载体——博客

  前面说到了”好记性不如烂笔头“，但是在纸上在文档中所作的笔记，我们什么时候回去翻看呢，只能说翻看的次数少之又少。只有在某个东西需要的时候，翻箱倒柜找个不停，然后发现丢失了。纸质的笔记本和电子的文档，记录后出现在眼前的机会少之又少，起不到整理备份的功能。大多数情况下，我们遇到问题，不是想着自己之前是不是有记录相关的文档，而是从网上直接度娘到解决方案或者是相关资料的介绍。原因是现在网络发达，随时随地可以上网，查找资料极为方便；另外一种情况是没有对自己的遇到的问题和总结出来的资料有深刻的印象，还有就是资料查找不方便，可能在云盘可能在本地磁盘，也可能在其他存储工具之中；但是造成的结果是，同一个问题每次要么要重复的花费时间搜索可解决的办法，要么从各种笔记本中搜索，时间就随之浪费掉了；
  最近发现CSDN博客的用于做笔记的方式是一种比较适合我的应用环境，写完的笔记可以在笔记本、PC、平板和手机上随时查看，也能通过这些设备写博客。写完的东西中合适分享的内容我可以公开出去，没准会有人看到，提供给别人更有价值的解决思路和办法，是对闭门造车的一种弥补；文章分门别类整理成为专栏，没事的时候翻来看看，看看有没有人给评论，哪些内容是大家所关注的，哪些资料是较少的。可以让自己在技术上更加深入研究，学习，然后总结分享，是一个学习的过程，也是一个总结复盘的过程，对人对己都是百利而无一害的事；

笔记的种类

  作为码农，平时的工作和学习基本上都是围绕开发语言和相关业务知识内容的学习和联系，所作下的博客基本上都是围绕着两方面做的笔记，可以说是技术笔记居多，顺便还有一些读书笔记；
  技术笔记细分有很多种，有学习某个开源框架的，某领域专用第三方库的，或者是某种语言学习的，又或者是记录项目中遇到问题的解决办法的；不同种类的文章的目的不同，以学习为目标的学习笔记或者教程文章，以解决问题为目的分享自己的解决方案或者是汇总网上现有的解决办法给出切实可行解决思路与办法；下面将分为两类，详细叙述；

某种技术或语言学习笔记

  这种情况下，博客文章一般会是一个系列的笔记或者是一个持续的学习过程，很难在一篇笔记中就将这项技术完整的学完；很可能的情况下，是对这种技术的某个技能点的学习，或者是框架的组织形式以及对一个功能的内部相关类的继承派生结构的讲解；这种情况下多篇文章就会在整个完成这个学习系列之前呈现出一种没有体系没有结构的状态，需要定期的将这些离散的知识点整理汇总成整体学习目录中的一部分，就像一本书中针对某个模块的完整的一个章节，之后可能会对这个章节的内容进行扩充或者修改，这都需要在学习的过程中不断的思考和付出行动。
  在学习的过程中，往往也会有其他博客对所要学习的内容有所介绍，就要分析整理，多看类似博客，取其精华去其糟粕，汇总成一篇有价值的笔记，类似论文中概述或者是国内外研究现状；**官网上给出的类说明和示例代码也是笔记的一部分，但是不是简单翻译或者照搬代码，一贴了之，而是应该给出代码，给出输入数据和呈现出输出的结果。**我之前关注的一个学习VTK的人号称自己的系列博客里有上千篇关于VKT的博客专栏，我还付了19块钱订阅了。细细看完，对照官方示例代码，完全就是一回事，这不是浪费感情吗。毫无感情的照搬官方代码，还美名其曰是技术专家写的上千篇技术博客，亏得粉丝量不多，简直是误人子弟；虽然自己做的不够好，但是我也是希望向好的方面发展，能够在某些方面帮到别人；
  总而言之，就是某种技术或语言学习笔记前期是散乱学习的知识点，给出学习笔记和试验代码，后期由浅入深整理出笔记顺序；

解决问题笔记

  这类笔记基本上是对遇到问题的总结和项目功能实现上的技术试水，将简陋功能代码示之以人，叙述自己的解题思路；基本上就是1.问题出现场景及现象；2.排除问题中使用的方法；3.定位问题的最终原因；4.解决问题的办法；5.查找问题过程中有用的参考文章；
  在这类笔记中，就会衍生出对某个技术点上的欠缺而需要学习的学习博客。

参考资料

1.我们为什么要做笔记？