出于这样那样的原因，本人觉得有必要再更新一版 Git 相关的配置流程。

参考这份教程前，请确认以下几点

1.已经正确安装 Git 并完成相关设置

2.已注册 GitHub 账号

3.确认你的网络环境稳定

配置Git本地仓库

打开Git bash

依次输入以下命令以设置username和email

1
2
git config --global user.name "username"	#自定义用户名
git config --global user.email "example@email.com"	#用户邮箱

username 和example@email.com改成你的用户名和邮箱

设置完成输入

1
git config --list

如果显示出你的 user.name 和 user.email ,就代表你设置成功了

接下来在你想要拉取仓库文件的位置创建一个文件夹

进入该文件夹右键空白区域打开Git Bash

输入以下命令将该文件夹初始化成一个 Git 可管理的仓库

1
git init

此时文件夹里多了个.git隐藏文件夹，它是Git用来跟踪和管理版本库的

配置SSH Key

首先，在本地的用户目录:C:\Users\<你的用户名>下，查询是否存在.ssh文件夹

如果有，再看文件夹下有没有id_rsa和id_rsa.pub这两个文件，如果也有，可直接到下一步

如果没有，在开始附录里找到Git Bash，输入以下命令，创建SSH Key

1
ssh-keygen -t rsa -C example@email.com	#这个邮箱是注册Github的邮箱

example@email.com改成你注册 Github 的邮箱

如果出现以下几行，直接按下Enter即可

1
2
3
Enter tile in which to save the key (/c/Users/lenovo/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

我们再次查看.ssh文件夹，已经有id_rsa，id_rsa.pub文件

这两个文件是SSH Key的秘钥对，其中id_rsa是私钥，不能泄露；id_rsa.pub是公钥，可以公开

接下来打开Github的Settings页面，找到SSH and GPG keys

点击New SSH key自定义你的Title，然后将id_rsa.pub里的内容粘贴到Key里，最后单击Add SSH Key就完成ssh配置啦。

将Github与Git远程连接

接下来在你想要clone仓库文件的位置创建一个文件夹

进入该文件夹右键空白区域打开Git Bash

输入以下命令将该文件夹初始化成一个Git可管理的仓库

1
git init

此时文件夹里多了个.git隐藏文件夹，它是Git用来跟踪和管理版本库的

建立本地文件夹和远程仓库的连接，这里我们以各位的任务仓库：Uranicial/2026MHP-member举例

1
git remote add origin git@github.com:Uranicial/2026MHP-member.git

git@github.com:Uranicial/2026MHP-member.git是该仓库的SSH连接

接下来把仓库里的内容clone到本地文件夹，输入

1
git pull origin main

完成以后本地文件夹就有仓库的文件了

拉取仓库文件/提交本地文件

在带有.git的目录下打开Git Bash

拉取仓库文件

拉取仓库的文件，以获取最新内容

1
git pull origin main

如果切换到个人分支时未发现main分支的新增内容，说明需要同步main分支改动

切换到你的分支

1
git checkout Uranicial	#'Uranicial'是分支名

执行合并命令

1
git merge main

如果主分支的修改与特性分支无冲突，Git 会自动创建合并提交；若存在冲突，则需要手动解决冲突

分支创建与切换

请以你们的英文名创建一个分支

这里用本人 Uranicial 举例

1
git branch Uranicial	#'Uranicial'是分支名

切换到分支Uranicial

1
2
3
git checkout Uranicial	
# 或者使用以下命令创建并切换到新分支
git checkout -b Uranicial

上述 Uranicial 改成你们英文名(提交作业时)，不是请自便

在你创建的分支下进行修改

请在2026MHP-member\下找到，命名为你们的英文名的文件夹，按各阶段的时间分别存放作业

如果没有对应时间的文件夹请自行创建

P.S. 主分支一般是main或者master

提交本地文件

建议在提交文件前先拉取一遍仓库文件(参考4.1)

在你创建的分支提交修改

先添加所有更改到暂存区

1
git add .

然后提交更改到本地仓库

1
git commit -m 26-10-29-T01-Uranicial

26-10-29-T01-Uranicial这一段可自行修改，建议按该格式填写以提交任务

推送更改过的分支到远程仓库

1
git push origin Uranicial	#'Uranicial'指上文创建的Uranicail分支

Pull Request & Merge

确认你的修改完成且上传至远程仓库后，就可以准备提PR(Pull Request)了

首先在远程仓库查看你的分支(Branch)这里依旧用分支Uranicial举例

找到Contribute按钮，点击后出现Open pull request

我们点一下它，进入Open a pull request界面，修改完title和description后点击下方的Create pull request按钮创建PR

一般来说仓库管理在review后确认无误会将该Branch直接Merge进main branch

如果存在一定问题管理会留下comment并Close pull request，请根据comment中提到的内容进行修改后再次发起PR

其他问题

端口 22 问题

在使用git push或其他 Git 操作时，如果遇到以下错误：

1
2
3
4
ssh: connect to host github.com port 22: Connection timed out 
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

这是由于默认的 SSH 22 端口被防火墙或网络策略限制，导致无法连接到 GitHub 的服务器

我们可以将连接改为 SSH 的 443 端口

打开C:\Users\<你的用户名>\.ssh文件夹

创建文件 config (无扩展名)

用记事本或者其他文本编辑器打开 config 文件，添加以下内容：

1
2
3
4
Host github.com
    Hostname ssh.github.com
    User git
    Port 443

保存并关闭

测试连接是否成功

1
ssh -T git@github.com

如果配置生效，你会看到类似这样的提示

Hi ! You’ve successfully authenticated…

说些什么吧！

giscus