技术写做是有技巧的

记得2013年9月1日，我开始在“开源中国”上发表博客，两年内我写了不少文章，同时也作了本身创立的开源项目，还认识了不少志同道合的朋友，最后也给本身带来了史无前例的机遇。感谢开源中国，它给我提供了一个很好的平台，让我能够在这个平台上尽情地发挥本身的价值。

其实我在写第一篇博客以前，就在纠结到底要不要写？本身能不能写好？若是写得很差，会不会被人“喷”？总之，都是一些负面的情绪，让本身没有勇气动手去作这件事情。

记得那是一个周末下午，不知道为了什么，我和老婆怄气了，多是由于小孩刚刚出生，天天哭哭啼啼的闹个不停，咱们都被折磨的心力憔悴。老婆在客厅里发飙，小孩在床上哭泣，我坐在卧室里对着“开源中国”网站首页发呆。

不知道本身是受了什么刺激，点击了开源中国网站上的“写博客”按钮，因而轻描淡写地完成了如下这篇短文：

Smart Framework：轻量级 Java Web 框架

今后，本身的技术写做之路就根本停不下来。

坦率地说，当时写这篇文章时，我内心是没底的。由于文章中所描述的这是一款开源技术框架，我只是对此框架提了几点需求而已，当时根本就没有一行代码，怎么能叫“开源项目”呢？我告诉身边的朋友：

开源并不是只是源代码的开放，而是思想的开放。

所以，我首先开放了本身的思想，而后才开放了本身的代码。具体过程是这样的，首先经过思想去和你们交换意见，而后得出合理的结论，最后产生具体的代码，再次循环迭代下去。我理解的开源就是这样的，它的本质实际上是一个颇有趣的社交活动，它的价值远远大于它的产出。

今天是10月24日，1024是程序员的数字，今天是程序员的节日。我想颇有必要为开源中国上的程序员们，写点本身在技术写做上的成长经历与我的体会，但愿本文能够给你们带来一点小小的帮助。

技术写做的价值

我认为写技术文章其实是对所学技术的再次理解与整理，经过文字的方式让本身的思路变得更加清晰。写技术文章须要不断积累，开头困难，后面轻松，并且积累到必定的量时，会产生质的飞跃，这一点我深有体会，相信写过技术文章的人也会有同感。

前几年我写了一些技术博文，几乎每周都写，最频繁能够作到“每日一博”，并且只在“开源中国”上发表。写技术文章不只是对本身专业技能的提高，并且经过技术文章的分享与传播，还会带来不少“化学反应”，主要体如今如下几个方面：

1. 让本身的文章可以帮助更多的人，产生更大的价值。
2. 让本身认识更多的朋友，也能从他们身上学到不少东西，包括知识与技能，也包括作人作事的态度。
3. 让本身被更多人关注，得到一辈子中可贵的机会。

当初我就是经过写技术博客，被电子工业出版社“博文视点”编辑部的陈晓猛老师关注到，陈老师鼓励我写书，两年内出版了两本《架构探险》系列图书。

技术写做的技巧

我认为写技术文章，首先要具有的能力是结构性思惟。我刚开始写技术博客时，一开始并没去列大纲，写到哪算哪，最后发现篇幅很难控制，并且本身都以为阅读起来不太舒服。后来我加以改正，在写具体内容以前，第一件事就是定义大纲，一级标题、二级标题，复杂状况可能还有三级标题。

定义大纲时是有技巧的，能够借助“思惟导图”工具来完成，并且大纲标题须要作到言简意赅。第二件事就开始完善每一个大纲中的内容，写文章相似于咱们写程序，先要定接口（大纲），再写实现（内容）。

在写内容时也有技巧，好比：

1. 要让读者感觉到，阅读这篇文章就像是做者在和读者对话同样，文章中能够用“我”或“咱们”来表示做者，用“您”或“你们”表示读者。
2. 并且要多用短句，避免长句，目的是让读者阅读起来更加舒服，若是感受句子太长时，能够在合适的地方用逗号断句。
3. 想让读者更有兴趣往下读，能够在正文开头编一个段子，但这个段子最好与文章有些关联性。
4. 文中插图要绘制精细，必定不要随意，正所谓“一图胜千言”，图好，文也好，才是真的好。
5. 文章结尾时必定要有总结，让读者读完文章后，可以快速抓到重点，产生一种“深刻浅出”的感受。
6. 无论对本身所写文章是否有把握，都要在结尾处代表文章还有不少不足，但愿获得你们批评与指正的话。

最后一件事情是为文章起一个吸引人的标题，一个好的标题会让文章得到更多的点击量和传播率，好文章每每就是内容好，并且标题也好。技巧还有不少，本身动手写起来之后，就会产生不少经验。

若是担忧本身没法坚持写下去，不妨给本身设置一个计划，好比多长时间能够写一篇文章。若是不知道本身应该写什么，不妨将本身从平常工做中所学到的技能作一个总结，固然也能够写本身的读书笔记或心得体会等。总之，写做兴趣是能够训练出来的。

从写博客到写书

记得出版社老师鼓励我写书时，我也担忧本身写不出来，毕竟一本书不像一篇博客，书的篇幅较大，先后还有必定的先后关联性，须要较强的内容组织能力，更须要坚强的毅力。我在写第一本书时，一口气写了50多页，而后就写不下去了，由于以为框架组织有问题。随后卷土重来，第二次写到100多页，仍然以为不合理，再次放弃。直到第三次才一鼓作气，写完了全书。花费了我将近半年的时间，才能写完一本书，可见周期较长，让人心力憔悴。

我在写第二本书时，总结了曾经犯下的错误，吸收了教训。一开始我就花了大量的时间作全书的大纲，经过三级标题来展示。第一章做为概述性内容，统领全书中心思想，随后的每一章，分别对第一章所涉及的内容，进行深度描述，每一章都是一个独立的板块，每一节都针对一个具体的问题。每章都按照统一的逻辑来组织，首先讲明白“是什么”，再讲“为何”，最后讲“怎么作”。每章最后一节再来一个小结，汇总一下本章的要点，以及为下一章作一个铺垫。

按照以上方法，不只让本身的写做思路更加清晰，并且也把写书当成一个项目来管理，这样本身也能更加有毅力地将全书写完。

最后的赠言

不要吝啬本身在知识上的积累，更不要将知识据为己有，知识用出来才是珍宝，闷在肚子里那是废物。

---

做者简介

黄勇，现任特赞科技 CTO，曾任阿里巴巴公司系统架构师。具备丰富的互联网软件架构经验与技术管理经验，擅长敏捷开发模式，推崇“轻量级”系统架构。国内开源软件推进者之一，活跃于国内知名技术社区，Smart 开源框架创始人，畅销书《架构探险》做者，技术大会讲师，企业内训师。热爱技术交流，乐于分享本身的成长经验。

特赞公司 www.tezign.com

特赞是一个具备创意基因的互联网技术团队，来自于人工智能、人机交互、大数据、SaaS 软件服务化、创意管理、广告媒体等跨学科背景的成员组成，毕业于哈佛大学、普林斯顿大学、哥伦比亚大学、复旦大学、浙江大学等国内外知名学府和 Facebook、阿里巴巴、新浪、盛大、豆瓣、奥美、Isobar 等著名公司工做经验。

---

点击获取《架构探险：从零开始写 Java Web 框架》

点击获取《架构探险：轻量级微服务架构》

点击获取《架构探险限量版战袍》

架构探险图书微信公众号