一、前言

        本地新建了一个代码库，需要保存至远程 Github。

二、新建远程仓库

        首先需要在 Github 网页端创建一个新的仓库，根据需要是否新建 README 和 LICENSE，如果新建的仓库空，可能需要处理冲突。为了仓库规范性，我建议可以新建 LICENSE，而 README 可以在本地手动编辑。

三、本地设置

1、初始化代码库

git init

此时默认的分支名称为 master，如果使用 Github 需要更改为 main：

git branch -m master main

当然也可以更改 Github 的默认分支名称。

2、添加远程仓库的地址

git remore add origin git@github.com:xxx/xxx.git

我这里使用的 SSH 方式进行克隆和下载，HTTPS 方式好像已经被 Github 取消了。使用 SSH 需要设置证书，详见：

git ssh key配置_git配置ssh key-CSDN博客https://blog.csdn.net/lqlqlq007/article/details/78983879

3、提交本地代码

git add .
git commit -m "Initial commit"

四、建立跟踪

        如果远程仓库为空，可以直接提交至远程，并同时建立跟踪：

git push --set-upstream origin main

          如果远程仓库不为空，需要先拉取远程，并同时建立跟踪：

git pull origin main --allow-unrelated-histories

然后会提示 pull 策略，可以设置 merge 或 rebase，这个根据个人需要修改，并且提示需要指定如何调和偏离的分支：

我这里设置为 merge：

git config pull.rebase false

再次执行：

git pull origin main --allow-unrelated-histories

会弹出一个编辑框，需要填写合并的说明，可以随便写：

然后 Ctrl + x：

然后大写Y：

回车即可。

此时就完成了本地的代码跟踪，最后进行代码提交，同时建立与远程上游的跟踪：

git push --set-upstream origin main

同步完成。