大家好，我是若川。持續組織了6個月源碼共讀活動，感興趣的可以點此加我微信 ruochuan12?參與，每周大家一起學習200行左右的源碼，共同進步。同時極力推薦訂閱我寫的《學習源碼整體架構系列》?包含20余篇源碼文章。歷史面試系列

本文是我（hockor）觀看張鑫旭的直播課 《關于我十二年的寫作經驗》 所做的學習筆記，其中加入了一些自己的觀點，如果你也曾經對寫技術文章有過無力、失落的情緒，希望本文能讓你重新燃起對技術文章寫作的熱情。

在每一個技術人的成長之路上，我相信一定或多或少受到過很多技術博客的影響，比如技術論壇方面較為出名的有 CSDN、博客園、掘金等等，又或者是比較有影響力的大佬們，比如張鑫旭、阮一峰等等的自建博客。那么我們為什么要去寫技術文章呢？我認為主要價值有以下幾點：

• 提升自己的技術思維能力，加深對技術點的理解

• 與更多的人進行觀點碰撞

• 傳播正能量，進行無私的分享

• 提升自己的知名度，建設品牌力

那么問題來了，相信很多人曾經或多或少都有過那么一絲沖勁，暗暗說著我也要成為張鑫旭那樣的人，我也要成為阮一峰那樣的人，但是當自己真的開始盯著電腦準備寫內容的時候，發現半天憋不出來一個字，原因也許有很多啊，但是根據我自己的真實感受，大概有以下幾種內心想法，你看看跟你的有沒有重合的：

• 我寫啥呢？好像這些別人都寫過了啊，而且寫的比我還好，算了不寫了

• 怎么寫啊，我好像只是簡單寫了個 hello world，我也沒用到那么高深的場景啊，算了不寫了

• 太麻煩了，寫個文章我還要畫圖，還要寫 demo，太累了，算了不寫了

• 我這文章寫的這么干巴巴的，連我自己都看不下去了，算了不寫了

• 哎，上周寫的那個文章也沒人看啊，我寫的意義是啥？算了不寫了

• 評論區有人懟我了，說我這里不對那里不對，太丟人了，算了不寫了

• ......

以上的經歷不知道你是否曾經有碰到過呢？對于我自己而言，我幾乎都有過，但是當我現在再回頭去看，我真的覺得自己有點搞笑，我給自己總結起來就是 3 個字：“戲太多”，在看完張鑫旭的直播課以后，我有了更多的共鳴和想法，接下來我們好好來看看這個問題 - 究竟如何寫好技術文章

關于選題

首先是技術文章的選題問題，這也是很多人在成功路上遇到的最大的一個問題，就是不知道自己寫什么？

其實技術文章可以寫的東西有很多，這里大致分為以下幾種：

新方法/新技術的布道：比如 JS 新特性，或者新的構建工具等等

技術方案總結類：比如弱網環境下的加載優化機制等等

優秀框架的體驗指南：比如 react SSR 從 0-1 的過程等等

自己覺得很厲害的小技巧：比如一些獨特的優化手段，JS 的黑魔法等等

原理剖析類：比如 XXX diff 原理等等

棘手問題的解決方案：比如CDN 被劫持的解決方案

其中前 3 點是比較適合新手同學入手的，你可以根據自己的實際情況從這些點去做切入。

同時這里還有個小技巧，就會新技術點的獲取，你可以去?

https://caniuse.com/ciu/index?

看看，去一個一個的研究這些內容。

對于寫作的初心，這里張鑫旭提到了幾點忠告：

• 別總想著一上來就搞個大新聞，別怕讓別人知道你是個菜鳥，誰又不是從菜鳥一步一步走過來的呢？

• 如果你永遠在等好的主題，好的靈感，可能你這輩子都敲不出來一篇文章

• 思考你自己的當下，思考你的一切

• 實在不知道寫啥的時候，寫寫自己的迷茫，寫寫自己的困惑，說不定你會遇到一個為你解惑的人

關于內容

對于一篇技術文章，其內容結構主要有以下幾點需要注意的

重點突出

我們寫一篇技術文章，其實目的應該是很明確的，比如是講解一個效果還是講解一個技術結論，所以在寫的時候有 2 點要注意：講結論的先給出結論、講效果的先放上效果圖。

其實原因很簡單，你想想你平時看文章，比如一篇文章寫的是 webgl 3D 效果，你肯定是奔著效果去的，結果作者從頭到尾一張效果圖都沒有，你看著還有樂趣嗎？又或者作者講解 XX 特性在不同端上的差異問題，結果看到最后都沒說明白差異點到底在哪里，試問這樣的文章你覺得是一篇合格的技術文章嗎？

所以如果你要寫一篇技術文章，首先你得搞明白你的目的是什么？是為了給別普及一個概念還是為了展示一個效果，針對自己不同類型的文章再去做重點的突出，你的文章內容就已經成功一大半了。

完整的敘事

關于文章框架，這里有以下一些可供思考

• 背景

• 你的思考

• 你的嘗試

• 你遇到的困難

• 你的解決方案

• 最后的結果

你可以在這個標準大綱上做自己的調整，基于這個路徑來寫一篇技術文章，你的邏輯和結構就會非常的清晰。

最后張鑫旭還提到一個就是針對個人感悟類的文章，他給的建議很直接：你想怎么寫就怎么寫~

關于表達

文章形式

是不是所有的技術文章都一定是一篇議論文或者是敘事文呢？其實不一定，這里再給出幾點不同的建議：

對話類的文章

如果你看過程序員小灰的文章，一定很有體會，這種類似于日常對話的寫作方式（如下圖），非常有代入感，同時如果你能配上漫畫，就更加的厲害了，說不定還可以給自己創造一個 IP。如果你不會畫漫畫，你可以將內容和微信 / 釘釘聊天框結合起來，網上有非常多的這種工具，也能給人很好的閱讀體驗。

同人小說類

不知道前段時間大火的《JavaScript 百煉成仙》你是否有聽說呢？這種文章你看看是不是一下子讓死板的知識點變的生動了起來，而且更容易理解了。

碎碎念的文章

最后這種，就是類似于張鑫旭的文章風格，你可以親自去看看讀讀，這種文章配合一些日常的段子啥的，也能起到非常不錯的效果。

換位思考

在寫完一篇文章以后，并不代表你的文章就已經可以發布或者推廣了，因為我們更多的是站在自己主觀的角度來寫的，所以為了保證文章的易讀性，你還可以從以下幾個方面去換位思考一下：

• 如果我是個小白，這篇文章我能看懂嗎？

• 如果我不認識文章中的縮寫詞，我能理解這篇文章嗎？

• 我這里要不要加個架構圖做說明呢？

• 我這里要不要加個演示圖做展示呢？

• 我這里要不要加一下代碼注釋呢，萬一對方是個初學者怎么辦？

• ...

以上的換位思考，是張鑫旭覺得寫作中最重要的的一個特質，因為通過以上的換位思考，會讓我們的表達變的更加的豐富，內容更通俗易懂。

同時還有一個技巧特別重要，就是把自己的文章多讀幾遍，早上睡醒的時候讀一下，晚上睡覺前讀一下，說不定讀著讀著，你的靈感又來了，同時還能發現不少錯別字😄😄😄。

保持初心

“展示你最真實的一面”

這是我們寫作中最重要的一個準則，在寫作中，一定一定要經常告訴自己這段話，你是一個什么樣的人，你就寫什么樣的文章

“我話癆，喜歡扯東扯西”，那就這么干，想到什么就寫什么；

“我御宅族”，挺好，多加入自己喜歡的元素，體現宅的氣質；

“我喜歡曬自己”，那文章就多配一些自己的圖，來展現自己；

“我是個窮酸小透明”，沒關系，過得不開心，文章也沒必要強顏歡笑，時不時的透出自己的小猶豫也挺好。

關于你自己

• 不要有功利心，少寫 XXX 面試指南，多寫真實的 case、感悟

• 保持自己的風格，維持自己的人設，不要一篇笑嘻嘻，一篇哭唧唧

• 勇敢寫，樂意寫，享受寫。

以上，與你共勉。

·················?若川簡介?·················

你好，我是若川，畢業于江西高?！，F在是一名前端開發“工程師”。寫有《學習源碼整體架構系列》20余篇，在知乎、掘金收獲超百萬閱讀。
從2014年起，每年都會寫一篇年度總結，已經堅持寫了8年，點擊查看年度總結。
同時，最近組織了源碼共讀活動，幫助3000+前端人學會看源碼。公眾號愿景：幫助5年內前端人走向前列。

識別上方二維碼加我微信、拉你進源碼共讀群

今日話題

略。分享、收藏、點贊、在看我的文章就是對我最大的支持~

總結

以上是生活随笔為你收集整理的如何写好技术文章（看张鑫旭老师的直播总结的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。