译者 | 刘涛
审校 | 重楼
最近，我参加了一场开源峰会，并被一个意外的发现所震撼。在一场关于社区贡献的小组讨论中，主持人向在场观众提出了一个问题：“在场的各位中，有多少人曾经为开源项目做出过贡献？” 只有少数人举起手。令人惊讶的是，尽管现场充满了对开源的热情，但许多参会者似乎对于如何迈出贡献开源项目的第一步仍感到迷茫和不确定。
目录
- 洞见贡献开源项目的无限可能
- 引言
- 什么是开源？
- 为开源做贡献的好处
- 如何开始参与开源贡献
- 非技术类开源贡献
- 结语
洞见贡献开源项目的无限可能
在峰会后的交流中，我发现了一个普遍的心声：许多人对参与开源项目心存畏惧，误以为只有技术精英才能做出有意义的贡献。这种普遍的担忧促使我撰写了这份指南。我希望通过这份指南，能够为大家揭开开源项目的神秘面纱，证明无论技术水平高低，每个人都能在这个充满活力的生态系统中找到自己的位置和价值。
引言
开源软件是许多我们日常使用的工具和服务的基础。从网页浏览器，到复杂的操作系统，再到支撑各类应用程序的底层库，开源项目在技术领域中扮演着极其重要的角色。
然而，对于许多技术新人来说，踏入开源项目的大门往往令人望而生畏。面对开源项目庞大的规模和复杂的结构，很多新手感到不知所措，既不清楚应从何处着手，也不知道如何能够做出有意义的贡献。
本文旨在为你提供一份详尽的指南，逐步引导你如何向开源项目贡献自己的力量。无论你是编程高手，还是新手，只要跟随本文的指引，你将能够掌握开始为开源项目做贡献所需的知识，并树立起参与的信心。
什么是开源？
在深入探讨如何向开源项目做出贡献之前，我们需要先明确“开源”这一术语的具体含义。开源软件是指那些遵循特定许可协议发布的软件，这些协议允许任何人自由查看、修改以及分发软件的源代码。这种开放与协作的模式极大地促进了技术创新与共享，使得从个人开发者到大型企业的各类参与者都能为开源项目的发展添砖加瓦。一些流行的开源项目包括：
- 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
