经验沉淀、定期思考，并以文章的形式进行记录和分享。工作中也一样，把许多经验整理成文档，当然也不乏“你工作就是写文章吧”这样的声音。至于为什么要这么做呢，我想谈谈我的一些想法。

程序员与文档的前世今生

我们程序员，最讨厌的就是看别人的代码，和没有文档。文档，其实是很小的一件事。项目也好，框架或是工具库都好，作为原作者或者踩过坑的，写文档其实并不会花很多的时间。

也遇到过，有人纯手动撸了一整个前端框架，好几个项目都在用，但是一句话文档都没有，甚至README都没有。怎么启动项目？有什么注意事项？新人来了都重新踩一遍坑，和口口相传。

写文档，其实也是个思考的过程。如果在做一个项目或是工具之前，有认真做设计、做方案、横向比较业界方案，会留下有系统设计的相关资料。

但为什么就很多人不愿意做呢？因为觉得更新代码的时候，还要更新文档很麻烦；项目太紧急了，没时间写文档；因为觉得与我无关；因为我已经能徒手造轮子了，文档不重要。

我们常常把“麻烦”、“没时间”的罪名强加在文档上，却经常忽略了缺乏文档带来的效率低下、设计不合理导致返工和事故等潜在问题。

我们的人生，并不能只固执于当下的利益和输赢。同样的，写代码也不能抱着“有问题再解决”、“写文档并不能给我带来什么收益”、“说不定明天这个项目就不存在了”这类的想法，做一件事，需要努力地想着怎么做得更好，而不是抱着无所谓的心态。

遗憾的是，快餐式的消费习惯，渐渐已经成为很多人的生活和工作方式。相比于需要长时间持续沉淀和学习才能获得的技能，很多人选择了囫囵吞枣、先做再说的方式。

越来越多的人每天的时间都安排很满，从而觉得自己真的很忙。而社会从悄悄惩罚那些不努力的人，变成了悄悄惩罚那些不思考的人。

知识共享的世界进程

在这个世界里，我们每个人都是独立的个体，然后相遇并组成一个个的集体。

互联网早已经出现了，共享的世界也越来越近了。

分享，交流，共同成长和提升，在这样一个过程里，很多人会有所收获。

很多人怕被超越，便悄咪咪地把自己所学所有藏了起来。但真正的核心竞争力，即使你共享出来，也没有人能复制。因为那是你独特的人生经历、性格脾气形成的，没有两个人是完全一致的。

如果，每个人都把自己踩过的坑填了，把积累的经验都沉淀下来，我们在奔向美好未来的路上是可以越跑越快的。每个人都要学习的课本、所有出版的读物、科研界的成果，不都是这样的存在吗？

我们每个程序员都会去的 Github，不也正是这样的存在吗？

狭隘的视角，局限的只是自己。外面世界的步伐，并不会因为某个井口太窄而受到阻碍。

很多事物需要记录

很久以前就有开始，每隔一段时间就做一段生活记录，反思、想象、或是单纯的记录。

接触代码之后，发现要学的东西太多了，也开始慢慢记录踩过的坑、自身的理解、经验的沉淀。接手一个项目，也会习惯性地补齐 README 和一些相关的说明文档。试用框架、工具的新能力，也会顺便记下一些总结和心得。

这些内容，最终都会落到文章的形式进行沉淀。同时，也顺手扔到博客里，或者其他平台上，若能恰好帮上一些人的忙，便再好不过。

如果遇到的一些问题，都能在网上找到解决方案。如果找不到答案的一些问题，能在解决之后顺手写下来。那后面来的人，甚至自己又遇到一样的问题，不就可以很快地修复吗？

工作中，也会遇到很多的牛人。而并不是每一位大牛都喜欢做分享和写文章的，好些厉害的人都是自己默默地玩耍代码，很多的思考和想法都藏在心里，只有偶尔的交流和讨论才能接触到。“哇，原来还能这么做”，“哇，这想法好棒”，真正接触到的时候，禁不住会有这样的想法。

这些精彩的思考方式，优秀的设计模式，也都想要记下来。很多改变世界的念头，都是在思想的碰撞中产生。所有的这些，属于我的，不属于我的，也都想要写下来。

这样，即使没有站在巨人的肩膀上，也能依靠每个人上山的时候铺下的路，齐心协力地登上峰顶，看到最美的风景了。

结束语

到如今，博客也坚持写了3年多了，而一些生活相关的文章，也断断续续地记录了快 5 年了。

如果说最大的收获，大概是在这个过程中一边敲下键盘，一边进行思考而沉淀下来的反省。而一路上的历程，也能以某种方式能看的到自身的成长，慢慢调整方向，越走越坚定。

我觉得这是个很好的习惯，同样地也分享给你们。生活中，职场中，会遇到很多的低谷，依然希望你们能攀上顶峰。祝好。

——————————————————————————
我的工作和生活，界限分明。如果你想要关注非工作非技术状态的我，欢迎关注“牧羊的猪”公众号。

查看Github有更多内容噢：https://github.com/godbasin
更欢迎来被删的前端游乐场边撸猫边学前端噢

如果你想要关注日常生活中的我，欢迎关注“牧羊的猪”公众号噢