2020年期間我有幸參加了啟智開源項目，在這個活動中，我主要參加了啟智磐石的開發，最終項目順利上線并開始提供服務，這次我想分享一下我參與這個活動以及開源社區的感受與收獲。

毫無疑問，參加一個開源項目是非常令人激動的，看著開源項目一步一步完善直到上線，這花費了我不少時間。但我從中也學到很多。由于以前并沒有參加開源項目的經驗，因此總結了一些心得，作為一個開源開發和之前工作中的不同之處。

1、在編碼風格方面不需要太嚴格

編碼風格的問題，當項目中設計了過于復雜的規則將增加開發的成本，人們會實時關注空格縮進帶來的困擾，最好的方式是能用腳本自動化處理開發中的編碼風格問題，比如將常用的eslint，go fmt工具封裝為全局腳本。這樣項目合作中可以很方便的進行溝通，而不需要經常通過人工來修改。最終，代碼的提交以pull request的方式進行合并，最終我一點都不擔心編碼風格、測試會帶來問題。

2、代碼即文檔

在開發的過程中我經常感受到，相比于不知道何時更新的文檔，編寫有清晰結構的代碼和測試比文檔更有用處。我可以毫不夸張的說：好的代碼就是好的文檔。當需要給系統增加功能時，最好的熟悉現有功能的方式不是找開發文檔和尋找當時開發文檔的開發人員進行詢問，當項目足夠健康時候，最好的方式就是閱讀結構代碼和測試。此外，別忘了swagger，當我們采用swagger時能夠快速生成api的文檔，這都能很好的提升開發速度。最后也有例外，比如當需要和第三方系統對接時文檔的重要性就不言而喻。

3、有高效的溝通方式

在項目開發過程中，項目進度的控制時至關重要，我們在項目開發中溝通采用類似github的模式，由開發或測試人員在項目管理中添加任務，管理人員指派成員，盡量避免無意義的會議，如果溝通的越順暢，我們自己就會越信任自己的項目。

4、多接觸其他的開源項目

經常關注開源社區的項目以及他們的issuse和pr，特別是目前Golang社區里有很多優秀的項目。在他們的issue中和pr中很多人對項目的理解都很高，他們樂于分享在項目中遇到問題，經常閱讀別人已經合并的pr已經代碼能夠拓寬視野，在遇到問題的時候能從多個角度思考問題。

5.收獲

參加這次的開源項目帶給我了很多收獲：

第一是讓我完全參與到開源之中，之前只在有些項目中提過一些pr去解決小問題，這次明確了開發目的切身體會了一次開源的感受。

第二在工作中也獲得了很多啟發，包括處理分布式大文件時候的一些項目經驗，使得我可以更好地理解研究問題中的一些概念。

作者：嚴翔東