記筆記這件事，也許在很多人看來，再普通、簡單不過了——從小老師就教育我們要這么做。不同的人有不同的方式，我們最終的目的，還是希望不要停留在只是記錄這一層面上，而是將它們轉變為我們的知識。作為一個程序員，今天我跟大家聊聊我的一些筆記管理的方法，希望對大家有用。如果大家還有更好的方式，也歡迎留言一起探討。

知識學習的路徑

首先聊聊知識學習的路徑。講得宏大一點，我們得先有方法論。知識學習的途徑可以分為以下幾個階段：

接觸，可能來源于工作中遇到的一個問題，或者朋友的推薦，或者逛社區、論壇時看到的新鮮內容。在接觸之前，我們并不知道，或者并不在意一個知識的存在，以及它是如何存在的。通過接觸，它勾起了我們的好奇心，激發了我們的熱情，吸引我們去實踐。

實踐，就是依照別人所描述的內容，或者自己個人的理解，動手去解決問題。只有經歷過實踐，才能摸清楚細節，才能更加具象、深刻地理解某項知識。而在實踐的過程中，我們可能會遇到各種狀況，別人未描述的或自己不甚理解的。通過各種其他手段，如查閱、咨詢等，最終解決了問題，豐富了知識適用的場景及其內涵。然后我們就需要把實踐的過程記錄下來，形成我們自己的認知。

總結，就是用自己的話去描述同樣一個知識。它的表述形式可能跟別人的不一樣，關注的細節點也可能不一樣。通過總結，形成我們認識事物的方式。這種方式繼而會影響我們在后續的實踐過程中的工作流程。一些較復雜的知識點也不是一次實踐或總結就能準確理解的，也許有疏漏。在后續的工作、學習中，我們使用這些尚未完全的知識，遇到困難，又繼續總結，形成一個反饋循環。直到達到一個較為滿意的狀態。這個時候，我們就可以考慮“為人師”了。

分享，就是把自己掌握的知識，用更多人能理解的方式講述、傳播出去。它跟總結的區別就是，不再是僅僅以個人能理解的方式去表達知識，而是要輔以通俗的語言、合適的圖文來表達。讓大家看到還有這樣一種角度、思路，成為他們的知識接觸點。

結構

這里我們討論的知識的主要載體，就是筆記。根據知識學習的路徑，我們可以對筆記進行分門別類。至少要單獨列出分享這一目錄。我常用的一級目錄為：

分享：包含所有待分享或已分享的文章、素材，使用日期作為子文件夾或文件名前綴。

開發：包含開發相關的知識點，如語言、工具、操作系統、網絡、中間件、架構等等

工作：包含各個公司、個人項目的工作內容與日常記錄

至于一級目錄以下的目錄劃分，可以根據每個人所側重的知識面來安排。

工具

那用什么做筆記呢？市面上已經有很多筆記管理軟件了，像 EverNote、有道等。不過作為程序員，我們手邊的開發工具就能做筆記管理。這里我推薦用 Visual Studio Code。它是一款非常輕量的 IDE 工具，有強大的插件體系。它不光可以用來寫代碼，還可以用來寫文檔，尤其是 Markdown 文檔。自帶 inline 樣式渲染，支持格式校驗、自動排版（尤其是 table）、PDF 導出等各種功能，還有很多插件可供你選擇。

Markdown，我想每個程序員都應該熟悉它的語法。其實核心的、常用的幾個語法很簡單，包括多級標題、多級列表、Code 等。像我寫這一篇文章，用到的也就無非這些語法點，額外多了圖片的插入等。根本不需要花多少時間。但是掌握它，不光有助于我們寫文章，包括開發中寫文檔，都是非常有用的。像我們常用的 Github、Gitlab 里，都可以直接渲染 Markdown 文件，Issue 中也能支持 Markdown 語法。學會一招，吃遍天下。很有必要。

也許有的同學會有疑問，那豈不筆記都是本地存儲了？這個問題很好。我們還需要一些工具，Git + Gitlab。將整個筆記目錄加入 Git 版本控制，這樣我們所有的筆記歷史都能保存起來。然后，我們可以在 Gitlab.com 的個人賬號上創建一個私有項目，同步我們的本地筆記到遠端。這樣，我們在公司使用公司的電腦，可以順利地同步；手機端也可以使用瀏覽器訪問 Gitlab 網址在線打開我們的項目，查看筆記。有了 Git 支持，即便多端修改產生沖突，也能很好地去解決。

擴展

用 VSCode + Gitlab 來管理我們的筆記，還有一個好處就是，這些筆記就是我們看得到的文件。那這里我們可以引申一下。把我們的筆記管理作為個人知識倉庫，它里面還能包含各種可以執行的腳本（如 Bash、Python）。這些腳本是我們自己編寫的、用來方便我們工作的。比如說我就寫了很多類似 Git 周報、Gitlab CI 自動化等這樣的腳本。它們不光能在我家里的電腦上執行，還能同步到我公司的電腦上，照樣執行。而且執行的方式不會有什么變化，不需要額外下載、保存、授權等各項工作，這些都在同步過程中解決了。十分方便。

當然，以上方式也有一些弊端，比如圖片不好處理，無法直接粘貼到文章里（也許有這樣的 VSCode 插件呢？）。不過至少我個人用起來，還是很舒服的。也希望這些內容，能為大家產生一些”接觸“點。