unknown
7.3 KiB
First Contributions（第一次贡献）
 |
Intellij IDEA |
|---|
第一次做某事总是困难的。尤其是在协作时，犯错误并不是一件舒服的事。但开源的本质就是协作与共同进步。我们希望简化新手学习与第一次参与开源项目的过程。
阅读文章和观看教程是有帮助的，但没有什么比“亲手实践又不会搞砸项目”更好的学习方式了。这个项目的目标是为新手提供指导，并简化他们第一次做出贡献的过程。记住：越放松，学习效果越好。如果你正在寻找第一次开源贡献的机会，只需按照以下简单的步骤操作。我们保证这将是一段有趣的旅程。
如果你还没有安装 IntelliJ IDEA，点击这里安装。
注意： 本教程使用的是 IntelliJ IDEA（版本 2019.3.2）在 Windows 10 系统上操作。教程中后续涉及的一些快捷键在 macOS 或 Linux 上可能会有所不同。
Fork 这个仓库
点击页面右上角的 Fork 按钮 Fork 此仓库。这将在你的 GitHub 账户中创建一个此项目的副本。
GitHub 会记录你 Fork 的仓库与原始仓库之间的关系。你可以把你的副本看作是一个工作副本。
大多数顶层 GitHub 仓库（即不是 Fork 而来的）只有一小部分核心团队成员可以直接提交更改。其他所有贡献者必须 Fork 该仓库，修改后提交 Pull Request 请求将更改合并回主仓库。一旦主仓库管理员批准这些更改，它们将被合并，而你将瞬间收获名誉与财富！稍后我们会介绍如何创建 Pull Request。
克隆你的仓库
下一步是将你的仓库克隆到本地，这样你就可以开始修改内容了。IntelliJ IDEA 需要你的仓库 URL，因此点击仓库页面上的 "Code" 按钮，然后点击“复制”图标。
注意： 新手经常犯的一个错误是克隆了原始仓库而不是自己的 Fork 仓库。请确认你复制的是你自己的仓库地址。
现在打开 IntelliJ IDEA。
IntelliJ IDEA 允许你检出（Git 中的 clone）一个已有的仓库，并基于下载的内容创建新项目。
在主菜单中选择 VCS | Get from Version Control，或者在没有打开项目时点击欢迎界面中的 Get from Version Control。
在打开的对话框中，粘贴你仓库的远程地址（你也可以点击 “Test” 测试连接），或从左侧选择一个 VCS 托管服务。如果你已登录某个服务，它会自动列出你可克隆的仓库。
点击 “Clone”。如果你想基于克隆的源代码创建 IntelliJ 项目，在确认对话框中点击 “Yes”。Git 根目录将自动设置为项目根目录。
如果项目包含子模块，它们也会被克隆并注册为项目根。
重要提示： 确保克隆的是你自己的 Fork 仓库，而不是原始仓库，否则不会生效。
创建分支
在 Git 中，分支是一种强大的机制，允许你从主开发线中分离出来，比如开发一个新功能或为发布冻结某个版本等。
在 IntelliJ IDEA 中，所有与分支相关的操作都可以在 Git 分支弹出窗口中完成。点击状态栏中的 Git 小部件，或按 `Ctrl+Shift+`` 唤出它。
当前检出的分支名称会显示在状态栏的 Git 小部件中。
在弹出窗口中选择 New Branch。
在弹出对话框中输入分支名称，确保勾选 “Checkout branch” 选项，这样你会自动切换到新建分支。
新分支会从当前的 HEAD 开始。如果你想从某个旧提交创建分支，可以在 Version Control 工具窗口的 Log 选项卡（快捷键 Alt+9）中选择一个提交，然后右键选择 New Branch。
进行必要的修改
打开 Contributors.md 文件，在文件中的任意位置添加你的名字。该文件使用的是 GitHub Flavored Markdown (GFM) 语法，是 Markdown 的一种扩展格式。
你可以复制其他贡献者的格式，并修改成你的名字，以确保语法正确 —— 有时语法会比较严格。
提交并推送更改到 GitHub
在 Version Control 工具窗口的 Local Changes 选项卡中，选择你要提交的文件或整个更改列表，按下 Ctrl+K 或点击工具栏上的 Commit 按钮。
在弹出的提交对话框中，会列出你自上次提交以来的所有更改文件及新增文件。
输入有意义的提交信息。
你可以按 Ctrl+M 打开提交历史，从中选择最近用过的提交信息。
你也可以在推送前随时修改提交信息。
按 Ctrl+Shift+K 或从主菜单选择 VCS | Git | Push。弹出的 Push Commits 窗口会列出当前分支所有未推送的提交。
提交 Pull Request 请求代码审查
此时你已完成了修改，但这些更改仍然只存在于你自己的仓库中。接下来我们将向原始仓库提交合并请求。
在你的 GitHub 仓库页面上，你会看到一个 “Compare & pull request” 的按钮。点击它。
接下来提交你的 Pull Request。
不久之后，你的更改就会被合并到主仓库的 master 分支中。一旦合并成功，你会收到邮件通知。
接下来可以做什么？
恭喜！你刚刚完成了标准的 fork -> clone -> 编辑 -> PR 流程，这将是你未来开源贡献中非常常见的工作流程！
庆祝一下你的首次贡献，并通过 web app 与好友分享你的成就吧！
如果你有任何问题，欢迎加入我们的 Slack 团队：加入 Slack 团队