譯者 | 劉濤

審校 | 重樓

最近，我參加了一場開源峰會，并被一個意外的發現所震撼。在一場關于社區貢獻的小組討論中，主持人向在場觀眾提出了一個問題：“在場的各位中，有多少人曾經為開源項目做出過貢獻？” 只有少數人舉起手。令人驚訝的是，盡管現場充滿了對開源的熱情，但許多參會者似乎對于如何邁出貢獻開源項目的第一步仍感到迷茫和不確定。

目錄

• 洞見貢獻開源項目的無限可能
• 引言
• 什么是開源？
• 為開源做貢獻的好處
• 如何開始參與開源貢獻
• 非技術類開源貢獻
• 結語

洞見貢獻開源項目的無限可能

在峰會后的交流中，我發現了一個普遍的心聲：許多人對參與開源項目心存畏懼，誤以為只有技術精英才能做出有意義的貢獻。這種普遍的擔憂促使我撰寫了這份指南。我希望通過這份指南，能夠為大家揭開開源項目的神秘面紗，證明無論技術水平高低，每個人都能在這個充滿活力的生態系統中找到自己的位置和價值。

引言

開源軟件是許多我們日常使用的工具和服務的基礎。從網頁瀏覽器，到復雜的操作系統，再到支撐各類應用程序的底層庫，開源項目在技術領域中扮演著極其重要的角色。

然而，對于許多技術新人來說，踏入開源項目的大門往往令人望而生畏。面對開源項目龐大的規模和復雜的結構，很多新手感到不知所措，既不清楚應從何處著手，也不知道如何能夠做出有意義的貢獻。

本文旨在為你提供一份詳盡的指南，逐步引導你如何向開源項目貢獻自己的力量。無論你是編程高手，還是新手，只要跟隨本文的指引，你將能夠掌握開始為開源項目做貢獻所需的知識，并樹立起參與的信心。

什么是開源？

在深入探討如何向開源項目做出貢獻之前，我們需要先明確“開源”這一術語的具體含義。開源軟件是指那些遵循特定許可協議發布的軟件，這些協議允許任何人自由查看、修改以及分發軟件的源代碼。這種開放與協作的模式極大地促進了技術創新與共享，使得從個人開發者到大型企業的各類參與者都能為開源項目的發展添磚加瓦。一些流行的開源項目包括：

• Linux：為許多操作系統提供支持的內核。
• Python：一種廣泛使用的編程語言。
• React：一個用于構建用戶界面的JavaScript庫。
• Mozilla Firefox：一款廣受歡迎的網頁瀏覽器。這些項目通常托管在GitHub和GitLab等平臺上，為開發者提供了便捷的協作和溝通渠道。開發者可以通過提交代碼、報告問題、參與討論和審查更改等方式，為這些開源項目的發展做出貢獻。

為開源做貢獻的好處

參與開源項目可以帶來諸多好處：

• 技能提升：通過參與實際項目，你將有機會親身實踐并學習最新的編程語言、開發工具以及行業內的最佳實踐。這種實戰經驗對于深化你的技術理解、提升編程技巧具有不可估量的價值。
• 社區互動：開源項目背后往往有一個龐大且充滿活力的社區作為支撐。這個社區由來自全球各地的開發者組成，他們樂于分享知識、交流經驗，并共同推動項目的發展，能夠幫助你在技術和個人成長方面取得進步。
• 人脈拓展：參與開源項目為你提供了一個與行業內其他開發者、潛在雇主以及科技領域專家建立聯系的平臺。這些聯系對于你的職業發展具有重要意義。
• 創建作品集：為開源項目做出貢獻是展示你技能和才華的絕佳方式。這些貢獻將成為你作品集中的重要組成部分，為你的未來雇主提供有力的證明。
• 產生影響：你的貢獻能夠直接影響全球成千上萬的用戶，幫助改善他人所依賴的軟件。這些用戶可能來自各行各業，他們依賴這些軟件來完成工作、學習或娛樂。

如何開始參與開源貢獻

開源項目參與之旅可以細分為幾個條理清晰、易于管理的步驟。這些步驟將引領你逐步完成從尋找合適的開源項目、深入理解貢獻方式，到最終提交你的貢獻并接受審核的全過程。

第1步：設置開發環境

在著手參與開源項目之前，搭建一個適宜的本地開發環境是首要任務。所需的具體工具會根據項目所使用的編程語言或技術棧而有所差異。以下是適用于大多數項目的基本設置：

1.Git：一個功能強大的版本控制系統，它能夠幫助你精確地追蹤代碼中的每一次更改，并促進多人之間的協作開發。你可以從git-scm.com下載并安裝它。

安裝后，設置你的 Git 用戶名和電子郵件：

git config --global user.name "Your Name"
 git config --global user.email "youremail@example.com"

2.GitHub帳戶：大多數開源項目都托管在GitHub上，因此請在 github.com上先創建一個帳戶。

3.文本編輯器：在挑選用于編寫代碼的文本編輯器或IDE（集成開發環境）時，你會面臨多種選擇。其中，Visual Studio Code、Sublime Text 和 JetBrains 系列IDE是備受歡迎的幾款工具。

4.編程語言：根據項目需求安裝必要的編程語言。例如，如果你正在參與Python項目，請確保你的系統上已經安裝了Python。

第2步：理解Git版本控制

版本控制是開源項目協作的基石，而Git則是這一領域的佼佼者，它使得眾多開發者能夠協同工作于同一項目之上，而不會相互沖突。在著手貢獻之前，深入理解以下Git核心概念至關重要：

• 倉庫（repo）：用于存儲項目代碼和文件的目錄。
• 復刻（Forking）：對項目進行復刻會創建一個該倉庫的個人副本，允許你在不影響原始項目的情況下進行修改。
• 克隆（Clone）：克隆操作會將整個倉庫復制到你的本地計算機上，以便你可以離線工作。
• 分支（Branch）：分支用于將你的更改與主代碼庫（通常稱為main或master）隔離。
• 拉取請求（Pull Request，簡稱PR）：拉取請求是一個提議，旨在將你在分支中所做的更改合并到原始倉庫的代碼庫中。

克隆倉庫：

git clone https://github.com/username/repository.git

為更改創建新分支：

git clone https://github.com/username/repository.git

第3步：找到要參與貢獻的項目

找到合適的開源項目是開源貢獻之旅的起點，也是至關重要的一步。以下是一些專為新手量身定制的查找適合項目的有效方法：

1.GitHub Explore：是GitHub平臺上一個極具價值的資源，專為尋找開源項目的用戶設計。在這個Explore頁面上，你可以方便地查找熱門倉庫以及按語言或興趣搜索項目，這些倉庫和項目往往聚集了大量的關注者和貢獻者，是了解和學習當前技術趨勢的絕佳窗口。

2.Good First Issues: 在開源社區中，為了鼓勵新手積極參與并降低初次貢獻的門檻，許多項目維護者會特別標記一些適合新手嘗試的問題，這些通常被稱為“good First Issues”。你可以通過在GitHub或其他平臺上搜索“good first issue”來找到這些內容。

3.開源社區：開源社區為新手提供了諸多友好的入門途徑，其中First Timers Only和Up For Grabs是兩個極具代表性的平臺，它們均列出了一系列適合新手參與貢獻的開源項目。

4.文檔檢查：在挑選開源項目時，務必關注那些提供了詳盡文檔的項目。完善的文檔能夠為你的貢獻之路提供明確的指引，使你能夠更順暢地參與到項目中。例如，如果你是一名Python 開發人員，則可以為Python官方文檔或一些流行的Python庫如Requests、Flask 或 Django 等做出貢獻。

第4步：理解項目

找到你感興趣的項目后，接下來的關鍵步驟就是深入了解并熟悉它。

1.閱讀README：閱讀README文件是參與開源項目時的首要任務。這個文件通常位于項目的根目錄下，是了解項目概況、設置方法以及貢獻指南的窗口。

2.檢查問題：在GitHub的項目倉庫中，仔細查看問題板塊。這里是記錄bug、功能需求及待辦事項的地方。特別留意那些標有“good first issue”或“beginner-friendly”等標簽的問題，它們往往是專為新手設計的貢獻起點。

3.在本地設置項目：克隆倉庫并在本地計算機上設置項目，以確保一切按README中的說明正常工作。例如，如果你正在處理Python項目，則可能需要通過pip安裝依賴項：pip install -r requirements.txt

4.閱讀貢獻指南：許多項目都有貢獻指南。這些指南可能涵蓋編碼風格、測試要求以及如何格式化提交信息等內容。確保你仔細閱讀并理解這些指南。

第5步：開啟你的第一次貢獻

現在是最有趣的部分，開始貢獻吧！以下是具體方法：

1.復刻倉庫：在GitHub上，點擊“Fork”按鈕以創建項目的個人副本。

2.克隆復刻：將復刻克隆到本地計算機上。 git clone https://github.com/your-username/repository.git

3.創建新分支：為每次貢獻創建一個新分支是一個好習慣：git checkout -b my-branch

4.進行更改：現在，進行你想要貢獻的修改。例如，如果你正在修復一個bug，可以在相應的文件中編輯代碼。如果你是在更新文檔，可以編輯README.md。假設你正在修復 README 中的拼寫錯誤：

# Incorrect text
 This is a sampe of a typo.

你可以改成：

# Corrected text
 This is an example of a typo.

5.提交更改：一旦完成修改，請用清晰簡潔的信息提交這些更改：

git add .
 git commit -m "Fix typo in README"

6.推送你的更改：將你的更改推送到 GitHub 上的復刻：

git push origin my-branch

第6步：提交拉取請求（PR）

既然你的更改已經推送到GitHub上了，現在是時候將它們提交以供審閱了。

1.前往原始倉庫：導航到原始倉庫（不是你復刻的那個）。

2.創建拉取請求：GitHub通常會顯示一個橫幅，提示你的分支已準備好創建拉取請求。請點擊“Compare & pull request”按鈕。

3.編撰說明：請清晰說明你所完成的操作及其原因。具體描述你的更改解決了什么問題。

一旦提交拉取請求后，項目維護人員將審查你的更改。他們可能會要求你進行修改或者直接批準你的更改。

第7步：回應反饋

維護人員可能會就你的拉取請求（Pull Request）提供反饋。請務必及時回應。如果他們要求你進行修改，請在本地進行這些更改，然后提交，將它們推送到你的復刻倉庫中。例如：

git commit --amend
git push --force

更改獲得批準后，你的拉取請求將合并到主項目中。

非技術類開源貢獻

盡管編碼等技術性貢獻常常被視為開源項目的核心，但實際上，開源項目同樣歡迎并珍視那些不需要編程技能的貢獻方式。這些貢獻同樣具有極高的價值，能夠為項目的成功和發展做出重要貢獻。

1.文檔

清晰、全面的文檔對于任何開源項目都至關重要，但它往往被忽視。作為非技術貢獻者，你可以為項目改進或編寫文檔，使新用戶和其他貢獻者更容易理解和使用軟件。

• 改進README：明確設置說明、使用示例和安裝流程。
• 編寫教程：創建分步指南或視頻教程，幫助新手入門該項目。
• 修正拼寫錯誤：糾正現有文檔中的拼寫、語法和格式錯誤。

2.社區支持與參與

眾多開源項目的繁榮發展離不開一個充滿生機與活力的社區。為這樣的社區貢獻力量，可以采取多種形式，如解答疑問、引導討論以及為初來乍到的新手提供支持。

• 通過在GitHub問題跟蹤系統或社區論壇中回答用戶的問題，幫助那些在項目使用中遇到問題的用戶。
• 確保論壇、郵件列表或社交媒體上的討論具有建設性且緊扣主題。
• 整理常見問題及其答案，以幫助用戶解決常見問題。

3.設計與用戶界面（UI）貢獻

項目往往需要在提升其用戶界面的視覺美感及用戶友好度方面尋求助力。如果你具有設計專業背景，可以通過創建原型、改進布局或提出用戶界面/用戶體驗（UI/UX）改進建議來貢獻力量。

• 為項目設計標識、圖標或插圖等視覺元素。
• 繪制原型圖，或提供關于如何使界面更加直觀易用的建議。

4.項目本地化與翻譯

確保開源項目能夠觸達全球受眾是至關重要的，這不僅能增加項目的知名度和影響力，還能促進全球范圍內的協作與創新。為了實現這一目標，需要將項目內容翻譯成多種語言，以適應非英語母語者的需求。

• 將項目文檔轉換為其他語言，擴大用戶群。
• 調整軟件界面、錯誤信息或網站，使其適應不同地區和文化背景。

5.市場推廣與對外宣傳

開源項目的持續發展離不開新用戶和貢獻者的加入。因此，制定有效的營銷策略至關重要。對于非技術背景的貢獻者來說，可以通過多種渠道來提升項目的知名度和影響力。

• 在Twitter、LinkedIn、Facebook等平臺上分享項目動態、更新和亮點。
• 撰寫關于項目的文章，介紹使用方法或解決的具體問題。
• 制作視頻教程或博客文章，幫助新用戶學習如何使用或參與項目。

6.活動組織與籌款

組織活動或籌集資金對開源項目的可持續發展至關重要。諸如活動策劃或財務支持等非技術性貢獻可以產生重大影響。

• 協助組織社區活動、黑客松（hackathons：是一種由程序員、開發者等IT行業人員參與的集思廣益的編程活動。它強調在短時間、高強度、重實操的條件下，通過團隊合作解決特定問題或開發新產品）或會議，促進開發者和用戶的交流。
• 支持籌款工作，通過眾籌活動或申請資助等多種方式，以確保開源項目擁有穩健的財務前景。

7.質量保證（QA）與測試

盡管軟件測試在許多人眼中是一項高度技術性的任務，但實際上，非開發者同樣能通過測試軟件的可用性和報告遇到的問題來為項目貢獻力量。非技術背景的用戶往往能為項目的用戶體驗提供極為寶貴的反饋。

• 識別并報告在使用軟件過程中遇到的缺陷或問題。
• 對軟件的易用性提供反饋，并建議改進方案。

8.法律與許可貢獻

開源項目在運營過程中，頻繁面臨許可證合規、服務條款遵循等法律層面的挑戰，確保項目在法律框架內穩健前行至關重要。

• 確保項目擁有法律許可相關證明，并遵守相關開源許可證要求。
• 協助制定貢獻者協議或其他法律文件，以保護貢獻者和項目本身的利益。

這些非技術性的貢獻對開源項目的長遠發展具有不可估量的價值。遺憾的是，它們往往被新手所忽視，他們可能錯誤地認為唯有技術才是貢獻的唯一途徑。事實上，開源社區的靈魂在于協作與共享，非技術貢獻者在培育這一精神中發揮著舉足輕重的作用。

結語

參與開源項目無疑是一段充滿意義的旅程，它不僅能夠助力開發者的個人成長，還能使一群志同道合的伙伴建立深厚的聯系，共同為軟件世界添磚加瓦，創造價值。

請記住，每一位貢獻者都是從零開始，或許你的初次貢獻微不足道，又或許在參與的過程中你會遭遇重重挑戰，但請切勿氣餒。開源社區以其開放和包容的特性而著稱，你的每一分貢獻都將轉化為無限的學習與成長契機，讓你在這個充滿活力的環境中不斷進步。

譯者介紹

劉濤，51CTO社區編輯，某大型央企系統上線檢測管控負責人。

原文標題：How to Contribute to Open Source Projects as a Beginner，作者：Fanny Nyayic