GitHub 使用手册

1. Steam++ 加速

        由于 GitHub 的主要服务器位于美国，因此，当从地理位置相对较远的地方，比如亚洲访问时，数据需要经过更多的网络节点，可能导致速度变慢。可以使用加速器，比如 Steam++ 进行加速，解决 GitHub 访问慢的问题。

        Steam++ 目前已改名为 Watt Toolkit，官网网址：https://steampp.net/。

        Steam++ 安装完成后，打开 Steam++ 软件，找到 Github 项，开启加速，开启后如下，之后就可以正常访问 Github 了。

2. GitHub 注册

        GitHub 是全球最大的代码托管平台，也是开发者们交流、协作和分享代码的重要平台。在使用 GitHub 之前，需要先注册 GitHub 账号。

2.1 打开 GitHub 官网

        官网地址：https://githu.comb/，进入官网后，点击右上角“Sign up”，之后会跳转到注册界面。

2.2 输入注册信息

        在账号注册界面，依次输入邮箱、密码、用户名，点击 “Continue”。

        注意：请使用常用邮箱，该邮箱之后会用于接收 GitHub 的通知和验证信息。

2.3 真人验证

        注册信息输入完成后，会进行真人验证，可以选择“视觉”或者“音频”验证。

        这里就是将物品的方向调整到手指指向的方向。

2.4 邮箱验证码验证

        真人验证成功后，之前注册的邮箱会收到验证码，打开邮箱。

        将验证码输入到输入框中，点击 “Continue”。

2.5 注册成功

        上述步骤完成后，将自动跳转到登录界面，点击“Sign in” 即可登录到 GitHub。

        登录之后的界面如下，至此，就已成功注册了一个 GitHub 账号，可以打开个人信息界面，修改头像、个人简介等信息。

3. 创建 GitHub 仓库（Repository）

        在 GitHub 上创建仓库是协作开发项目的第一步。仓库（Repository），是存储代码、文档和其他相关文件的地方。以下是在 GitHub 上创建仓库的详细步骤：

        1. 点击下图中的 “+”，在弹出的选项中选择 “New repository”

        2. 填写仓库信息；

• Repository name：仓库名字，最好简单明了，能反映项目的用途；

• Description：描述，简单介绍一下该项目，便于以后自己或其他人了解该项目；

• Public/Private：公共/私有，选择该仓库是公开还是私有，公开的仓库，其他用户也能查看和克隆，私有的仓库只有受邀者才能访问；

• Initialize this repository with a README：是否使用 README 初始化仓库，README 文件中，通常会包含项目的一些基本信息，可以选择是否需要创建该文件；

• Add .gitignore：添加 .gitignore 文件，.gitignore 文件用于指定在提交代码时，应该忽略哪些文件或者目录，比如编译生成的日志文件等；

• Choose a license：选择一个许可证，为项目选择一个合适的许可证，有助于明确项目的使用、修改和分发规则。

        上述信息填写完成后，点击 “Create repository” 即可创建仓库，创建的仓库如下：

        仓库创建完成后，就可以上传代码、文档等到仓库中了，也可以对上传代码、文档进行下载、更新等操作。

4. 克隆（Clone）仓库到本地

        在 GitHub 上，克隆（Clone）一个仓库是将远程仓库（位于 GitHub 服务器上的仓库）的所有内容（包括代码、提交历史、分支等）下载到本地计算机的一个副本的过程。以便于在本地计算机对代码进行修改、更新等。以下是将仓库克隆到本地的步骤：

        1. 获取该仓库的 URL，复制该 URL；

        2. 打开命令行工具，推荐使用 GitBash，如果没有，可以到官网进行下载，官网地址：https://git-scm.com/downloads/win。

        在需要克隆仓库的目录下，打开 GitBash，输入：

git clone 刚刚复制的 URL

        3. 克隆完成后，会在本地计算机中，创建一个新的目录，通常和仓库名同名，之后就可以使用 Git 命令来提交修改、查看提交历史了。

5. 提交和推送代码

        在 Git 中，提交（Commit）用于将本地的代码更改保存到本地仓库，推送（Push）用于将更改同步到远程仓库。这两个操作保证了开发的有序进行，确保了代码的版本控制和团队协作开发。

        每次修改项目后，需要将修改提交保存到本地仓库中，每次提交都会创建一个新的提交对象，它包含了本次更改的文件列表、作者信息、提交者信息、提交信息以及指向父提交的指针。这些提交对象形成了一个有序的历史记录，之后可以通过 git log 来查看提交历史。

        以下是提交和推送的步骤：

        1. 查看修改项；

git status .

        2. 添加要提交的文件；

git add . //添加全部修改
git add 文件    //添加指定文件

        3. 创建一个提交对象，“描述更改内容” 部分主要是对这次修改进行一个说明，便于之后查看;

git commit -m "描述更改内容" 

        4. 使用 git push 将本地修改推送到远程仓库；

           1）先创建一个远程仓库的引用；

git remote add origin <远程仓库 URL> 

           2） 将本地的 main 分支推送到远程仓库的 main 分支。

git push origin main

        至此，就将本地修改推送到了远程仓库中，之后可以在远程仓库中查看对应的修改了。

6. 创建分支

        一般情况下， GitHub 会默认创建 master 分支，开发者在不干扰主分支的情况下，可以根据需要创建其他分支，将修改提交到其他分支上，最后再通过合并操作，将其他分支的修改合并到主分支。

        点击 master 旁边的下拉箭头，可以创建新的分支或者切换到其他分支。

        在提交代码的时候，根据需要，选择相应的分支。

7. 合并代码

        将代码 push 到远程仓库后，在 GitHub 上，可以创建一个合并请求（Pull Request，PR），请求将推送的修改合并到主分支或者其他分支。

        1. 新建 Pull Request；

        2. 选择要将哪个分支的修改合并到哪个分支；

        3. 合并请求创建后，其他团队成员可以审查代码修改，当审查通过后，在合并请求页面，点击 “Merge pull request ” ，就可以将更改合并到目标分支了；

        4. 之后，在本地仓库中，拉取最新的更改，确保本地代码和远程仓库中的代码一致。

git pull origin 分支

        本文只介绍了 GitHub 的注册和基础使用，其他功能待日后继续分享。如文档有误，欢迎指出。