如何寫出一篇技術博客

2021-02-20 MavenTalk
引子

眾所周知,寫博客是一種入門門檻低,療效好,還能帶來長期影響力的過程。幾乎每一位愛上寫博客的開發者總是樂於向其他人分享寫博客的樂趣和益處,但即便如此,身邊的人還是很難體會到寫博客的好處。

哪怕有時有的公司付費鼓勵員工通過知識庫的形式分享平時自己遇到的問題和解決問題時的思考,也鮮有員工薅到這樣的羊毛,這確實是一件令人費解的事情。會不會是由於同事們不差錢呢?顯然並非如此,每個月從200元到500元不等的獎金,每年累計下來也要大幾千,估計很少有人能夠克制這樣的誘惑。

其實也許是因為存在一種心理障礙。年輕的開發者們還沒有完成心路歷程的轉變,沒有深刻的體會到寫博客其實不是寫作文,它不需要靈感,也不需要寫出太高大上的文字,他的門檻其實是如此之低,與其說是知識輸出,倒不如說是更像是軟文或應用文。有時,你無需花太多的時間,只需按照一些簡單的套路,其實就能踏上這條賊船。隔行如隔山,信息不對稱的危害可見一斑。

寫博客的套路就是:提出一個問題,分析問題,解決問題,記下來。

啥華麗的辭藻,啥專業的解讀,啥深度剖析,這些都不重要,這些都是循序漸進的過程。經典的小說千千萬,經典的博客卻少之又少。作為菜鳥的我們,又何必追求寫出那麼經典的博客呢?

為了讓讀者能夠更加切實的體會這個觀點,本文就是這樣的示例代碼(本文雖然是一篇博客,同樣像一篇應用文,前面鋪墊大家都可以理解為廢話。

1、提出問題在軟體開發過程中,我們經常會遇到各種各樣的問題,有的看起來毫不起眼,但也讓人發人深思,有的問題則看起來就很複雜,但解決之道卻如此簡單。舉一個很簡單的例子:Thread.Sleep方法,好像參數只需一個整型數,就能享受讓主線程阻塞的優雅性能。(阻塞線程顯然不能帶來性能快感,但有時吧。。)但你想過沒,這個Thread.Sleep的最小值,居然不是0,而是-1,這是為啥呢?如果你發現了這個問題,並提出這個質疑,也許一篇優秀的文章就在等著你。(當然,就.NET而言,微軟官方已經圍繞這個問題進行了解釋)。當然,這樣的例子非常常見,我們也可以從http協議開始理解,這種無處不在的協議,究竟是如何運作的?這也是一個很不錯的問題。2、分析問題透過問題的表象,看看問題本質的東西,這本身也許需要積累,有時也需要一些機遇。但在我們初涉博客時,只需多從幾個角度剖析問題,藉助一些知識整理,也許就能看到之前從未涉及的視角。有時,我們也不必糾結寫博客質量太低,擔心被人稱作南郭先生,其實大部分友好的技術社區大部分正常的讀者,對持續堅持寫博客的博主總是比較友好的。多關注於技術和作品本身,反而有助於我們屏蔽外界幹擾,並從鑽研技術的過程中獲得更多樂趣。3、嘗試解決問題依託網際網路媒介,尋找問題的解決辦法,並將解決問題的過程客觀真實的描述下來。有時也許只需一行代碼,或一個流程圖,就能給讀者解決很多問題。4、稍微修飾一下當然,如果你能再寫完博客後,花一點點時間對內容進行一些修飾,自然而然就會獲得更多的讀者了。加強文章的排版,注意字體大小的錯落,注意換行等。在手機上閱讀大段大段的文字著實不便,如果我們能控制每段的文字數大概在100字左右,也許讀者會輕鬆許多。去掉那些過於華麗的辭藻。作為一篇技術博客,辭藻華麗不僅僅沒有優點,反而會讓讀者遠離。。注意引文的實時性。考慮到技術博客本身刷新的頻率特別高,如果你能基於最新的知識體系進行寫作,自然而然也會讓更多開發人員從中獲益。適當的留下伏筆。雖然一篇文章力求解決一個問題,但如何能夠為下一篇文章介紹的內容埋下伏筆,也能讓你的博客獲得更多吸引力。5、多堅持一下對大多數人而言,技術寫作是一件令人困惑的事情,俯拾即是的技術問題,難免都會讓人產生動筆的衝動,但自我懷疑和混亂迷思,卻打破了我們的思考節奏,讓我們最終沒能邁出這一步。我們也可能會在文思泉湧和下筆如枯之間搖擺,有時搜出一些邊邊角角的話題,然後寫出了一篇越寫越沒勁的話題。但也許,我們的工匠精神也正是在這樣的每一瞬間慢慢積累,並讓我們最終獲益。拋棄幻想,放下自我,讓博客能夠更好的成為我們成長的利器,投入更多的堅持到我們真正需要關注的東西本身--技術上,確實會讓我們獲益匪淺。在追求網際網路速度、被各種應用幹掉了大部分碎片時間的我們可能很難抽出寫一篇博客的時間,但我們可以嘗試一周輸出一篇1500字的博客。每天花15分鐘稍微寫一點點,再周末花一點點時間打磨一下,也許一篇質量還不錯的博客就形成了。

相關焦點

  • 如何編寫一篇的技術BLOG
    基於我個人近幾年寫博客的一些經驗和收穫,聊聊如何寫一篇高質量(主題明確、結構清晰、乾貨滿滿)的技術BLOG。碎片化知識沉澱如何輸出?寫BLOG是很好的方式。正向反饋寫了技術BLOG,就放心大膽的發布,讓更多的人看到,看到了才會有評論,通過別人的視角,發現自己的不足,在後面的BLOG編寫中,不斷提升,形成一個正向的反饋循環。
  • 怎麼寫好一篇博客?寫博客有什麼好處?
    怎麼評價你掌握了某個技術呢?接下來我將從寫作的內容、形式、平臺、工具及技巧上給大家講一下如何寫好博客博客類型1.問題類博客記錄錯題集或踩坑記錄。3.技術分享類博客技術分享類博客也屬於研究總結性博文,這種博文難度大、也比較消耗時間和精力、但同時對別人啟發也大,是自己對某個問題進行的詳細總結,例如《卷積神經網絡匯總
  • 如何寫出另人刮目相看的中英文Email
    本周我偶遇了一篇博文How to Write Better Email(如何寫出更好的電子郵件)。裡面的建議非常實用,且中英文郵件通用。 原文作者是 Lazarus Lazaridis,一位來自希臘的程式設計師。
  • 博客即簡歷
    過程很順利,和技術主管聊得很愉快,做了一個多小時的筆試內容他直接沒看,他說,我有看過你的博客,還不錯,看得出你是一個學習能力很強的人,繼續寫下去,多出好博客。第二天HR就聯繫我,談了薪水和到職日。我內心自然是欣喜的,沒想到這麼快就定下來了。緣起我從去年起,給自己一個規定,每個月至少寫三篇博客。主要是有兩個原因,一個是逼自己提高對知識整理和對情感表達的能力;二個是逼自己多學。
  • 很難寫出一份令人滿意的履歷?專家教你如何寫出一篇完美的個人履歷
    6、CV 應該描述以achievements為基礎的相關背景,而不是 something happens to you. 因此不要寫成 Experience working in7、「Detail-oriented」。 你是這樣的人,難道別人不是嗎?寫出你自己獨特的地方。
  • 程式設計師為什麼值得寫博客?
    這個過程就是一個個為什麼你會看到那麼多本優秀的計算機書的原因,大師分享了他們的心得告訴我們如何去成為大師,不過我還不是。只是如果你要成為大師,就要去分享你的過程。至於為什麼?簡單的說幾點:1、技藝的掌握在於重複。技術和遊玩的相同之處在於技術玩得越多,也就越熟悉,當你試著去寫一篇博文的時候,你也回顧了過程。遊玩的回味可以再次歡樂,博文的書寫可以再次熟悉。2、你的過程正是別人所需要的。
  • 聊聊,快速提升技術有哪些方法可以借鑑?
    如何防止不忘記?說實話,沒有太好的辦法,最好的辦法,就是記筆記或者寫博客,將學習過程中的知識點整理成筆記,後面就算忘記了,看看筆記,也是很快就可以再掌握的。關於筆記相關的軟體比較多:有道筆記、typora等等,非常方便。
  • 為什麼你應該(從現在開始就)寫博客
    下面是我個人認為寫一個長期的價值博客的最大的幾點好處:1) 能夠交到很多志同道合的朋友。我自己既寫博客,也讀別人的博客,在這個時代,對於生活中的絕大多數人來說,拓寬朋友圈子的途徑幾乎只有一個,通過網絡,而如何在網絡中尋找到氣味相投的朋友,如何判斷別人和自己是否有共同語言?
  • 阿興博客——我的啟蒙老師——我與阿興博客徵文選登54
    當時最大的問題就是轉正,學習了不下10位老師,但是當時真的,可以說他們的轉正技術,基本就是靠運氣。在本質上是沒有任何突破,更談不上技術,概率是不穩定的。而我個人堅持認為,這個是有技術的。正巧一天晚上,和群友聊天,他說他會轉正技術,阿興那裡學的。腦子本能的想到,阿興是誰。於是百度,花一晚上看了阿興老師的博客,記得好像學費是3000多。
  • 網賺屌絲的成長之路--我與阿興博客」徵文選登1
    阿興語:自從前幾天發布「我與阿興博客」主題徵文正式開啟後,想不到參與的兄弟還不少
  • 如何寫出一篇好的簡報
  • 如何寫出一封急著跳槽又不失禮貌的離職信?
    時常看許多同事,找到新工作,急著前公司放人,但其實離職信一直都是一門藝術,用一些看似騙人的藉口,主管早就知道,你想走但不誠懇,今天我想跟大家分享我一個外國前同事,是怎麼用英文寫出一篇得體又情文並茂的離職信
  • 如何擼一篇殺手級的軟體工程師簡歷
    我是如何完成的?在這篇文章中,基於以下幾個目標,我將對我的簡歷進行逐行分析:闡述我在創作簡歷過程中作出的選擇我為何相信簡歷能夠幫助我獲取面試機會你怎樣才能創作出更好的簡歷我第一次找工作的時候,費了很大週摺才進入面試,因此我決定寫這篇文章。如果當時能有一篇有實際應用的簡歷範例給我看,一定會對我大有幫助的。
  • 牛人是如何在網上賺錢的?
    所以,這裡我提出了一個小白最關心的問題,牛人是如何在網上賺錢的?其實,這個答案很簡單,倪葉明用一句話就能形容:學習和鍛鍊一個絕活,把這個絕活不斷反覆的運用即可。(把這句話好好的思考一下,然後再套到你所關注的一些牛人身上去驗證一下看看)看似簡單的一句話,實際上真正能夠做到的人真的極少極少極少。
  • 一篇乾貨教會你!
    作者的姓氏不出現在行文中,例如:…(Sharma and Tan, 1994)…(Huang, 2019)注意:【在第六版中】如果引用的一篇文章有3到5個作者,第一次引用要把所有作者都列出來,例如:(Kernis, Cornell, Sun, Berry, &
  • 手把手教你如何寫一篇優秀的自我介紹
    自我介紹是一個面試的開端,也是你給面試官留下的第一印象,一篇好的能在面試一開始就給面官留下良好的印象,並且為你接下來的面試做好鋪墊,幫助你順利的通過面試,而一個不夠好的自我介紹則會反其道而行,留下難以扭轉的壞印象,而且可能為後面的面試挖坑
  • 程式設計師如何像寫程序一樣寫作?
    如果讀者自認為已經對Markdown有所了解,或者不想糾纏於技術概念,想快點進入「如何使用Markdown」的議題,也可以選擇跳過這一章。第2章 寫作的前期準備:在這一章中,我們首先介紹了幾款值得一試的Markdown編輯器。
  • 如何寫出一份漂亮的英文CV?
    那麼如何寫出一份漂亮的英文CV呢?這裡面還是有很多講究的,今天微課君就帶大家一起,從格式、內容、用詞等方面,來學習如何寫好一份個人簡歷,無論是為了交作業,還是對於以後出國申請、求職應聘,希望大家都能從中受益,掌握技巧。  微課資源福利,回復「CV「,給您英文CV的模板(好壞各兩種example)英文簡歷與中文簡歷格式有所不同,因此一定要修改排版。
  • 微譯分享-入門翻譯如何在網上找到兼職翻譯工作
    我的生活照 我在深圳,做自由翻譯的,也就是兼職全國各大翻譯公司以及企業的翻譯業務,下面我給大家講一下如何在網上尋找到翻譯工作3:多認識業內人士,這樣你可以百度搜索例如上海優秀翻譯,深圳優秀翻譯,北京兼職翻譯等關鍵詞,多翻幾頁,我相信你可以認識很多業內人士,多和他們溝通交流,有些翻譯會介紹給你們他們沒空做的項目, 4: 最好有自己的博客,圖文並茂,每次翻譯項目儘量拍照,尤其大型項目,這裡,你可以搜一下我的博客,百度深圳翻譯 宋雪即可。