程序员的技术博客写作指南

程序员书单

共 2773字,需浏览 6分钟

 ·

2021-01-19 12:33



在开发过程中我们总会碰到这样那样的问题,神奇的是这些问题在网上基本能找到答案,不仅佩服这些大神大婶。

曾几何时,我也想成为他们那样的人,但对于写博客这件事一直敬而远之

编程本来就够无聊,写作更无聊,这两个无聊的东西加起来真不是稀顶就能解决的,可能得稀后脑勺。

2020让我想通了很多事,比如除了生死其他都是小事,比如要写技术博客。

为什么要写技术博客

  • 技术沉淀

    1. 总结归纳:做技术的前几年其实大家的差距并不明显,但是到后来,大概5年左右,有人依然初级程序员,有人已经是架构师了。当然其中有很多因素影响,但很重要的一条是归纳总结的习惯,而写作是归纳总结的有力工具。在写作过程中能梳理思路,查漏补缺,有些想法在编程时并未想到,却在写作中想到。写的多了,知识点会连成线,结成网。

    2. 增强记忆:俗话说好记性不如烂笔头,随着年龄的增长,记忆力每况愈下。写作无疑是增强记忆的有效工具。

    3. 纠错:,人在很多方面认知不足,有时甚至是错的。往往自己察觉不到。但是通过分享,会有些喷子和大神给指出来。这样认知不断更新迭代,就不会出现太多谬误。在正确的认知下会越走越远,越走越开阔。

  • 打造个人IP

    当今世界要说什么最值钱,影响力绝对占据一席之地。网红、明星为什么赚钱,就是因为他们的影响力,各行各业的大神都做自媒体,当然不是为了赚那点流量费,而是在扩大自己的影响力。未来人人都是自明星,中国市场这么大,任何一个小领域都有无限可能,谁的影响力大,谁就是赢家。而写作又是一个扩大影响力的工具。IP比较大的有阮一峰、廖雪峰、王垠等,每个小圈子也都有自己的明星。他们还用愁35岁会不会失业,编程干不动了该怎么办的问题吗?自然不需要。其他行业也都有了自己的网红,期望IT界的网红就是你。

  • 职场加分

    不知道大家有没有发现,有自己的博客去找工作是一个很不错的加分项。最起码说明你是一个善于总结学习的人,下来面试官可以通      过博客更多的了解你,最好是把自己认为非常不错的文章置顶,以此显示自己的水准。

为什么迟迟没写技术博客

很多小伙伴知道写博客的价值,也有过写博客的想法,但是出于种种原因始终没迈开第一步。近期采访了几位小伙伴,我总结了几个突出的原因。

  1. 不知道写什么,可以写一个简单的用法、冷门知识、课堂笔记、编程心得、技术分享、项目分享,项目中遇到的问题以及解决方案等。有小伙伴觉得太简单谁都会,没必要写。其实不管你写什么,都有人会,有人不会。再牛的人都有自己的认知短板。

  2. 害羞,怕写的不好没人看,写错了被嘲笑、攻击。其实完全没必要,只有不断有读者正面反馈才会不断进步。只要你敢写就有人敢看,只要有人敢批评,咱就敢改正。

  3. 追求完美,很多程序员对代码有洁癖,凡事力求完美,但是写作这个事没有完美,何况是刚开始。作家海明威说过:“一切文章的初稿,都是狗屎。” ,大作家都有这样的心态,我们又有什么放不开的呢?此时完成比完美更重要。

如何写技术博客

  1. 明确写作目的和受众

    首先要明确写作目的,受众人群。也就是给博文定调,是轻松幽默、力求详尽,还是严肃认真、专业概括,亦或者其他风格。

    • 提出问题->分析问题->解决问题->总结经验,技术问题分享。

    • 摘要->简介->分支主题->总结,一般技术分享。

    • 是什么-原理-背景>解决了什么问题->基本操作->同类对比->总结 ,适合新技术分享

    • 自己看,就是随笔,个人笔记。可以随笔写,甚至可以是一句话,一张图。完全可以是自嗨文。

    • 技术分享,这时就要考虑全面,不能写成自嗨文,要有一定的套路,要明确受众是哪些群体,是小白,还是高手,或者是领导。根据受众的喜好和自己的能力圈适当发挥。

    • 约稿,一般情况甲方都会给一定的格式和要求,再结合技术分享的经验成稿。

      自嗨文:网络流行词,就是调子很高,辞藻华丽,但没站在用户立场上写的文章。

    • 制作思维导图

      有时写着写着就写不下去了。如果提前搭好框架,做成思维导图,就会轻松很多,不至于写到一半卡壳。技术博客一般结构都是总-分-总。下面是一些我自己用的模板分享出来,做抛砖引玉用,各位如果有其他模板不妨分享出来,我们共同进步。

    • 参考文献

      在写作过程中会遇到认知盲区,或者有更权威的表达,我们可以引用,引用最好权威,注意要标明出处。建议引用占博文的比例不超过10%,太多就成了抄袭。如果实在不知道从何入手,如何写,也可以参考其他同类文章,有时完成一篇博文要参考几篇甚至几十篇文章。有些诚实的小伙伴会说这不成了抄袭吗? 抄袭和借鉴还是有本质区别,况且小白入手都是模仿,学习同行。慢慢就会有自己的风格和套路。

    • 排版markdown,几乎是所有博客网站的标配

去哪写

  现在写技术博客的地方还是比较多,下面列举几个比较主流的

  • csdn :这是国内最老牌的博客论坛,大家比较熟悉,优点:seo做得很好,用户量太大;缺点:很臃肿,广告满天飞,对新人不是很友好,很难脱颖而出。

  • 博客园:这是第二老牌的博客网站了,优点同样是seo比较好,用户量大。缺点:写作体验太差,像上个世纪的东西,不过它可以自定义博客样式,美化博客。

  • 掘金,平台比较新。优点就是比较清爽,写作体验很好,可以写自己的小册子赚钱。缺点是seo做得太差,搜索引擎基本看不到掘金的文章,很多软广告,带有面试字样的标题都是送资料引流的。

  • v2ex 技术氛围也不错,就是个人不太喜欢它的界面风格。

  • 思否,更多的专注于技术问答的平台。回答质量也很高。

  • 腾讯云社区 很多大牛,不太适合新人。写一段时间后可以去里面同台竞技。

  • 阿里云云栖社区  同腾讯云社区

  • 简书  不是专门的技术网站,但也支持markdown,seo权重高。

  • 知乎  更专注于问答,seo权重高,适合引流。

  • 公众号,没有门槛,原则上要把自己的粉丝引到公众号上来,值得长期经营。

  • 独立建站,就是比较麻烦,但是更容易掌控,自己的地方自己说了算。一些大牛都有自己的博客网站。

    比如 廖雪峰阮一峰轮子哥,知乎“温赵轮”三大软狗之一 王垠等。

    大家可以根据自己的喜好选择合适的平台发布自己的文章,也可以多平台发送,分布式,扩大影响力。选择平台的因素是


    • SEO

    • 影响力

    • 自己喜好

总结

写博客是百利无一害的事情,只要坚持,一定会有意想不到的收获。不问西东,干就完了。

希望本文对你有所帮助,欢迎转发、评论、点赞。原创不易,你也可以。

— 【 THE END 】—
本公众号全部博文已整理成一个目录,请在公众号里回复「m」获取!


3T技术资源大放送!包括但不限于:Java、C/C++,Linux,Python,大数据,人工智能等等。在公众号内回复「1024」,即可免费获取!!





浏览 44
点赞
评论
收藏
分享

手机扫一扫分享

举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

举报