阅读其他语言版本。

首次贡献

本项目旨在简化并指导初学者进行首次贡献。如果你想进行首次贡献，请按以下步骤操作。

如果你不熟悉命令行，这里有使用GUI工具的教程。

如果你的电脑上没有安装git，请先安装。

Fork 这个仓库

点击本页面顶部的fork按钮来fork这个仓库。这将在你的账户中创建一个本仓库的副本。

克隆仓库

现在，将fork的仓库克隆到你的电脑上。进入你的GitHub账户，打开fork的仓库，点击代码按钮，然后点击_复制到剪贴板_图标。

打开终端，运行以下git命令：

git clone "你刚才复制的url"

其中"你刚才复制的url"（不带引号）是本仓库的url（你fork的项目）。参考之前的步骤获取url。

例如：

git clone git@github.com:这是你的用户名/first-contributions.git

其中这是你的用户名是你的GitHub用户名。这里你是将GitHub上first-contributions仓库的内容复制到你的电脑上。

创建分支

切换到仓库目录（如果你还没有切换）：

cd first-contributions

现在使用git switch命令创建一个分支：

git switch -c 你的新分支名

例如：

git switch -c add-alonzo-church

进行必要的修改并提交这些修改

现在用文本编辑器打开Contributors.md文件，添加你的名字。不要将它添加到文件的开头或结尾，而是将其放在中间的任何位置。然后，保存文件。

如果你进入项目目录并执行git status命令，你会看到有修改。

使用git add命令将这些修改添加到你刚才创建的分支：

git add Contributors.md

现在使用git commit命令提交这些修改：

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

将你的名字替换为你的名字。

将修改推送到GitHub

使用git push命令推送你的修改：

git push -u origin 你的分支名

将你的分支名替换为你之前创建的分支名。

<details> <summary> 如果在推送时遇到任何错误，请点击这里： </summary>

认证错误
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre> 请参考GitHub的教程，了解如何生成并配置SSH密钥到你的账户。

</details>

提交你的修改以供审核

如果你访问GitHub上的仓库，你会看到一个Compare & pull request按钮。点击该按钮。

现在提交pull request。

不久后，我会将你所有的修改合并到这个项目的主分支中。一旦修改被合并，你将收到一封通知邮件。

接下来做什么？

恭喜！你刚刚完成了标准的 fork -> clone -> edit -> pull request 工作流程，这是你作为贡献者经常会遇到的！

庆祝你的贡献，并通过访问web应用与你的朋友和关注者分享。

如果你需要任何帮助或有任何问题，可以加入我们的slack团队。加入slack团队。

现在让我们开始为其他项目做贡献吧。我们整理了一个易于入手的问题列表，你可以从中开始。查看web应用中的项目列表。

附加材料

使用其他工具的教程

<a href="gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://yellow-cdn.veclightyear.com/0a4dffa0/a21be59d-bf13-4ca5-8f98-d2434968582d.svg" width="100"></a>	<a href="gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a>	<a href="gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://yellow-cdn.veclightyear.com/0a4dffa0/4e70dd61-b99a-4403-9419-1af5bb8f0700.png" width="100"></a>	<a href="gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://yellow-cdn.veclightyear.com/0a4dffa0/627d0151-85c0-4cad-83b9-750f969a46f8.svg" width=100></a>	<a href="gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://yellow-cdn.veclightyear.com/0a4dffa0/97122ca9-8d99-444d-bbeb-7241e4d94cc5.svg" width=100></a>	<a href="gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://yellow-cdn.veclightyear.com/0a4dffa0/cbac7809-c2a1-4eb7-8ad4-f7e746060aa9.png" width=100></a>
[GitHub Desktop](https://github.com/firstcontributions/first-contributions/blob/main/gui-tool-tutorials/github-desktop-tutorial.md	[Visual Studio 2017](https://github.com/firstcontributions/first-contributions/blob/main/gui-tool-tutorials/github-windows-vs2017-tutorial.md	[GitKraken](https://github.com/firstcontributions/first-contributions/blob/main/gui-tool-tutorials/gitkraken-tutorial.md	[Visual Studio Code](https://github.com/firstcontributions/first-contributions/blob/main/gui-tool-tutorials/github-windows-vs-code-tutorial.md	[Atlassian Sourcetree](https://github.com/firstcontributions/first-contributions/blob/main/gui-tool-tutorials/sourcetree-macos-tutorial.md	[IntelliJ IDEA](https://github.com/firstcontributions/first-contributions/blob/main/gui-tool-tutorials/github-windows-intellij-tutorial.md

本项目由以下机构支持： <a href="https://www.digitalocean.com/"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c207cdbd-2f8a-4ed5-9aed-7b84653c0b96.svg" width="201px"> </a>