一、准备工作

1. 本文以Github为例，其他代码托管平台类似。
2. 本文以SSH URL 为例，因为在push时，不需要输入用户名及Personal access tokens，如果配置SSH key的时候设置了密码(需要输入密码)，否则直接不需要输入密码。
3. 具体创建Github仓库的方法，懂得都懂，这里不过多说明。

1.1 申请 Personal access tokens

1. SSH URL忽略此步骤。
2. HTTPS URL 在push的时需要验证用户名和Personal access tokens。

1. 点击右上角的头像，然后选择Settings（设置）。

   

2. 在左侧导航栏中，选择Developer settings（开发者设置）。

   

3. 在Developer settings页面上，选择Personal access tokens（个人访问令牌）
4. 在Personal access tokens页面上，点击Generate new token（生成新令牌按钮）

   

5. 提供一个描述以标识该访问令牌的用途。
6. 在Select scopes（选择范围）部分，选择要授予该令牌的权限。这些权限将决定该访问令牌可以执行哪些操作。根据需求选择合适的权限，例如repo（仓库），admin:org（组织管理）等。
7. 完成设置后，点击页面底部的Generate token（生成令牌）按钮。

注意:生成的访问令牌将显示在屏幕上，请确保复制该令牌并妥善保存。一旦离开该页面，将无法再次查看完整的访问令牌。

1.2 Git安装

Debian:

sudo apt install git

Fedora:

sudo dnf install git

可通过git --version 命令查看，正常输出Git版本号即安装成功。

1.3 配置用户名和邮箱名

命令如下:

git config --global user.name "Your Name"
git config --global user.email "email@example.com"

配置完后可以通过以下命令查看:

git config user.name
git config user.email 

1.4 配置SSH公钥

创建公钥文件，生成的公钥文件会保存在本机的~/.ssh目录下:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

然后三步询问直接回车即可(连续三次回车)。

创建完成后进~/.ssh目录，(将公钥即id_rsa.pub的内容)复制出来:

cd ~/.ssh
cat id_rsa.pub

如果进入该目录时提示No such file or directory，自己手动创建一个即可:mkdir ~/.ssh

将公acee放入GitHub，以ssh-rsa开头

二、开始上传

1. 2020年10月1日后，Github会将所有新建的仓库的默认分支从master修改为main。
2. 初始化仓库后:git branch -m main 把仓库名改为main，如果需要推送其他分支，改成需要推送的分支名。

终端进入我们需要上传项目所在的文件夹，使用Git的初始化命令:

git init # 初始化一个新的Git仓库

上传之前，我们需要添加上传的文件，这里我们要上传当前文件夹内的所有文件:

git add ./ # 把文件添加到暂存区

查看当前项目的分支与添加文件情况:

git status

提交暂存区的文件到版本库:

git commit -m "提交项目相关信息" # 把暂存区内容提交到本地仓库

添加创建的Git仓库，命名为origin 远程仓库示例:

git remote add origin git@github.com:Linux-qitong/hexo-theme-solitude.git
# 添加远程仓库地址，如果显示fatal:远程 origin 已经存在，可以先删除本地仓库和远程仓库的连接，再进行连接
git remote rm origin
git remote add origin git@github.com:Linux-qitong/hexo-theme-solitude.git

使用push指令进行上传。

git push -u origin main # git push <远程仓库名> <远程分支名> 这里origin是默认远程仓库别名，main是分支名

如果是采用https url 会提示输入:

username:Your Name
password:申请的Personal access tokens

再次刷新GitHub上传成功。

三、解决方案

下面是一些常见的解决方案来修复这些错误：

3.1 添加远程分支追踪

在新的代码仓库中，需要配置远程分支追踪：

git branch --set-upstream-to=origin/main main

3.2 允许无关的历史合并

遇到了fatal：refusing to merge unrelated histories.

通常是因为本地代码仓库和远程代码仓库之间存在不同的提交历史，可使用以下命令：

git pull origin main --allow-unrelated-histories # 这个命令将允许合并无关的历史

3.3 强制推送修改(多人仓库不推荐)

如果遇到：Updates were rejected because the remote contains work that you do not have locally.

这说明远程代码仓库中包含了本地仓库没有的更改。 可使用以下命令：

git push origin main --force # 强制推送本地的更改，并覆盖远程代码仓库

3.4 遇到fatal: Exiting because of unfinished merge.

3.4.1 如果想完成这个合并，解决所有可能存在的冲突：

git commit -m “Complete merge”

3.4.2 如果想取消合并：

git merge --abort

3.4.3 一旦合并完成或取消，可再次尝试推送更改：

git push origin main

四、命令扩展

4.1 创建推送标签:

git tag -a v1.1 -m "Version 1.1" # 创建一个标签，1.1版本

4.2 将刚刚创建的标签推送到远程仓库:

git push origin v1.1 

4.3 创建新分支:

git checkout -b <新分支名> # 创建新分支

4.4 推送新分支:

git push origin <新分支名> # 推送文件到新分支