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

本文是我（hockor）觀看張?chǎng)涡竦闹辈フn 《關(guān)于我十二年的寫作經(jīng)驗(yàn)》 所做的學(xué)習(xí)筆記，其中加入了一些自己的觀點(diǎn)，如果你也曾經(jīng)對(duì)寫技術(shù)文章有過無力、失落的情緒，希望本文能讓你重新燃起對(duì)技術(shù)文章寫作的熱情。

在每一個(gè)技術(shù)人的成長之路上，我相信一定或多或少受到過很多技術(shù)博客的影響，比如技術(shù)論壇方面較為出名的有 CSDN、博客園、掘金等等，又或者是比較有影響力的大佬們，比如張?chǎng)涡瘛⑷钜环宓鹊鹊淖越ú┛汀Ｄ敲次覀優(yōu)槭裁匆懠夹g(shù)文章呢？我認(rèn)為主要價(jià)值有以下幾點(diǎn)：

• 提升自己的技術(shù)思維能力，加深對(duì)技術(shù)點(diǎn)的理解

• 與更多的人進(jìn)行觀點(diǎn)碰撞

• 傳播正能量，進(jìn)行無私的分享

• 提升自己的知名度，建設(shè)品牌力

那么問題來了，相信很多人曾經(jīng)或多或少都有過那么一絲沖勁，暗暗說著我也要成為張?chǎng)涡衲菢拥娜?#xff0c;我也要成為阮一峰那樣的人，但是當(dāng)自己真的開始盯著電腦準(zhǔn)備寫內(nèi)容的時(shí)候，發(fā)現(xiàn)半天憋不出來一個(gè)字，原因也許有很多啊，但是根據(jù)我自己的真實(shí)感受，大概有以下幾種內(nèi)心想法，你看看跟你的有沒有重合的：

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

• 怎么寫啊，我好像只是簡(jiǎn)單寫了個(gè) hello world，我也沒用到那么高深的場(chǎng)景啊，算了不寫了

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

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

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

• 評(píng)論區(qū)有人懟我了，說我這里不對(duì)那里不對(duì)，太丟人了，算了不寫了

• ......

以上的經(jīng)歷不知道你是否曾經(jīng)有碰到過呢？對(duì)于我自己而言，我?guī)缀醵加羞^，但是當(dāng)我現(xiàn)在再回頭去看，我真的覺得自己有點(diǎn)搞笑，我給自己總結(jié)起來就是 3 個(gè)字：“戲太多”，在看完張?chǎng)涡竦闹辈フn以后，我有了更多的共鳴和想法，接下來我們好好來看看這個(gè)問題 - 究竟如何寫好技術(shù)文章

關(guān)于選題

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

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

新方法/新技術(shù)的布道：比如 JS 新特性，或者新的構(gòu)建工具等等

技術(shù)方案總結(jié)類：比如弱網(wǎng)環(huán)境下的加載優(yōu)化機(jī)制等等

優(yōu)秀框架的體驗(yàn)指南：比如 react SSR 從 0-1 的過程等等

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

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

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

其中前 3 點(diǎn)是比較適合新手同學(xué)入手的，你可以根據(jù)自己的實(shí)際情況從這些點(diǎn)去做切入。

同時(shí)這里還有個(gè)小技巧，就會(huì)新技術(shù)點(diǎn)的獲取，你可以去?

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

看看，去一個(gè)一個(gè)的研究這些內(nèi)容。

對(duì)于寫作的初心，這里張?chǎng)涡裉岬搅藥c(diǎn)忠告：

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

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

• 思考你自己的當(dāng)下，思考你的一切

• 實(shí)在不知道寫啥的時(shí)候，寫寫自己的迷茫，寫寫自己的困惑，說不定你會(huì)遇到一個(gè)為你解惑的人

關(guān)于內(nèi)容

對(duì)于一篇技術(shù)文章，其內(nèi)容結(jié)構(gòu)主要有以下幾點(diǎn)需要注意的

重點(diǎn)突出

我們寫一篇技術(shù)文章，其實(shí)目的應(yīng)該是很明確的，比如是講解一個(gè)效果還是講解一個(gè)技術(shù)結(jié)論，所以在寫的時(shí)候有 2 點(diǎn)要注意：講結(jié)論的先給出結(jié)論、講效果的先放上效果圖。

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

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

完整的敘事

關(guān)于文章框架，這里有以下一些可供思考

• 背景

• 你的思考

• 你的嘗試

• 你遇到的困難

• 你的解決方案

• 最后的結(jié)果

你可以在這個(gè)標(biāo)準(zhǔn)大綱上做自己的調(diào)整，基于這個(gè)路徑來寫一篇技術(shù)文章，你的邏輯和結(jié)構(gòu)就會(huì)非常的清晰。

最后張?chǎng)涡襁€提到一個(gè)就是針對(duì)個(gè)人感悟類的文章，他給的建議很直接：你想怎么寫就怎么寫~

關(guān)于表達(dá)

文章形式

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

對(duì)話類的文章

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

同人小說類

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

碎碎念的文章

最后這種，就是類似于張?chǎng)涡竦奈恼嘛L(fēng)格，你可以親自去看看讀讀，這種文章配合一些日常的段子啥的，也能起到非常不錯(cuò)的效果。

換位思考

在寫完一篇文章以后，并不代表你的文章就已經(jīng)可以發(fā)布或者推廣了，因?yàn)槲覀兏嗟氖钦驹谧约褐饔^的角度來寫的，所以為了保證文章的易讀性，你還可以從以下幾個(gè)方面去換位思考一下：

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

• 如果我不認(rèn)識(shí)文章中的縮寫詞，我能理解這篇文章嗎？

• 我這里要不要加個(gè)架構(gòu)圖做說明呢？

• 我這里要不要加個(gè)演示圖做展示呢？

• 我這里要不要加一下代碼注釋呢，萬一對(duì)方是個(gè)初學(xué)者怎么辦？

• ...

以上的換位思考，是張?chǎng)涡裼X得寫作中最重要的的一個(gè)特質(zhì)，因?yàn)橥ㄟ^以上的換位思考，會(huì)讓我們的表達(dá)變的更加的豐富，內(nèi)容更通俗易懂。

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

保持初心

“展示你最真實(shí)的一面”

這是我們寫作中最重要的一個(gè)準(zhǔn)則，在寫作中，一定一定要經(jīng)常告訴自己這段話，你是一個(gè)什么樣的人，你就寫什么樣的文章

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

“我御宅族”，挺好，多加入自己喜歡的元素，體現(xiàn)宅的氣質(zhì)；

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

“我是個(gè)窮酸小透明”，沒關(guān)系，過得不開心，文章也沒必要強(qiáng)顏歡笑，時(shí)不時(shí)的透出自己的小猶豫也挺好。

關(guān)于你自己

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

• 保持自己的風(fēng)格，維持自己的人設(shè)，不要一篇笑嘻嘻，一篇哭唧唧

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

以上，與你共勉。

·················?若川簡(jiǎn)介?·················

你好，我是若川，畢業(yè)于江西高校。現(xiàn)在是一名前端開發(fā)“工程師”。寫有《學(xué)習(xí)源碼整體架構(gòu)系列》20余篇，在知乎、掘金收獲超百萬閱讀。
從2014年起，每年都會(huì)寫一篇年度總結(jié)，已經(jīng)堅(jiān)持寫了8年，點(diǎn)擊查看年度總結(jié)。
同時(shí)，最近組織了源碼共讀活動(dòng)，幫助3000+前端人學(xué)會(huì)看源碼。公眾號(hào)愿景：幫助5年內(nèi)前端人走向前列。

識(shí)別上方二維碼加我微信、拉你進(jìn)源碼共讀群

今日話題

略。分享、收藏、點(diǎn)贊、在看我的文章就是對(duì)我最大的支持~

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。