# 第一次参与开源

github第一次参与开源

Open Source Love (opens new window) License: MIT (opens new window) Open Source Helpers (opens new window) (opens new window)

该项目旨在简化和指导初学者做出首次贡献的方式。如果您希望做出第一次贡献,请按照以下步骤操作。

如果您对命令行不熟悉,这里有使用 GUI 工具的教程。 (opens new window)

万事开头难。尤其是和其他人合作时,犯错总是格外令人不舒服。不过,开源的本质就是和其他人合作。这个项目就是希望为初学者带来一个简单的方法去学习及参与开源项目。

你可以选择阅读文章和观看教程来得到帮助,但实际动手才是最好的学习方式。本项目旨在简化并指导初学者参与他们的第一次开源。记住:过程越轻松,学习效益越高。如果你想要做出第一次贡献,只需按照以下简单步骤操作即可。这将很好玩 😃

如果你的电脑上尚未安装 git, 请按照 这个 (opens new window) 进行安装。

# 分叉此存储库

fork this repository

点击图示中的按钮去 Fork 这个代码仓库。 这个操作会将代码仓库复制到你的账户名下。

# 克隆存储库

clone this repository

接下来将复制后的代码仓库克隆到你的电脑上。点击图示中的绿色按钮,接着点击复制到剪切板按钮(将代码仓库地址复制下来)

随后打开命令行窗口,敲入如下 git 命令:

git clone "刚才复制的 url 链接"
1

"刚才复制的 url 链接"(去掉双引号)就是复制到你账户名下的代码仓库地址。获取这链接地址的方法请见上一步。

copy URL to clipboard

譬如:

git clone https://github.com/你的Github用户名/first-contributions.git
1

'你的 Github 用户名' 指的就是你的 Github 用户名。这一步,你将复制到你账户名下的 first-contributions 这个代码仓库克隆到本地电脑上。

# 新建一个代码分支

下面的命令能在命令行窗口中,把目录切换到 first-contributions

cd first-contributions
1

接下来使用 git checkout 命令新建一个代码分支

git checkout -b <新分支的名称>
1

譬如:

git checkout -b add-myname
1

(新分支的名称不一定需要有 add。然而,在新分支的名称加入 add 是一件合理的事情,因为这个分支的目的是将你的名字添加到列表中。)

# 进行必要的更改并提交这些更改

打开 Contributors.md 这个文件,更新文件内容,将你的名字加上去,保存修改。git status 这命令会列出被改动的文件。接着 git add 这命令则可以添加你的改动,就像如下这条命令。

git status
git add Contributors.md
1

现在就可以使用 git commit 命令 commit 你的修改了。

git commit -m "Add <你的名字> to Contributors list"
1

<你的名字> 替换成你的名字

# 将更改推送到 GitHub

使用 git push 命令发布代码

git push origin <分支的名称>
1

<分支的名称> 替换为之前新建的分支名称。

# 提交您的更改以供审核

前往 Github 你的代码仓库,你会看到一个 Compare & pull request 的按钮。点击该按钮。

create a pull request

接着再点击 Create pull request 按钮,正式提交 pull request。

submit pull request

不久之后,我便会把你所有的变化合并到这个项目的主分支。更改合并后,你会收到电子邮件通知。

# 接下来做什么呢?

恭喜!您刚刚完成了作为贡献者经常遇到的标准分叉 -> 克隆 -> 编辑 -> 拉取请求工作流程!

为你第一次的贡献庆祝吧,不要忘记和你的朋友以及迷弟迷妹们分享我们的网站 (opens new window)哟!

如果有任何疑问或想获得更多协助,欢迎加入我们的 Slack (opens new window)

还等什么,马上加入到其他项目的开发中去吧。为了方便你快速上手,我们收集了当前流行的众多代码仓库中,适合初学者解决的问题列表 (opens new window)

# 附加材料 (opens new window)

# 使用其他工具的教程

GitHub Desktop Visual Studio 2017 GitKraken VS Code Sourcetree App IntelliJ IDEA
GitHub 桌面 (opens new window) Visual Studio 2017 (opens new window) GitKraken (opens new window) Visual Studio Code (opens new window) Atlassian Sourcetree (opens new window) IntelliJ IDEA (opens new window)