如何将项目上传到Github（包含报错记录）

将项目上传到 GitHub 的基本步骤如下：

1. 准备（安装git）

• 访问Git 官方网站 。
• 下载适用于当前操作系统的 Git 安装程序。
• 打开下载的安装程序，一直点下一步，安装。

2. 在 GitHub 上创建仓库：

• 登录到 GitHub，点击右上角的加号图标，选择 “New repository”。
• 输入仓库名称、描述等信息，选择公开或私有，然后点击 “Create repository”。

3. 在本地初始化 Git 仓库：

• 打开项目的根目录文件夹，右键，Open Git Bash here
• 执行以下命令初始化 Git 仓库：

  git init
  

4. 添加和提交文件：

• 使用以下命令将项目中的文件添加到暂存区：

  git add .
  

• 添加指定文件（以index.md为例）（20240419补）

  git add index.md
  

• 使用以下命令提交暂存区中的更改到本地仓库：

  git commit -m "Initial commit"
  

• 如果报错error: remote origin already exists.，解决方法见8.1。
• 如果报错error: failed to push some refs，解决方法见8.2。
• 设置分支名（以main为例）（20240419补）

  git branch -M main
  

5. 关联本地仓库和 GitHub 仓库：

• 在 GitHub 仓库页面复制仓库的 URL。
• 使用以下命令添加远程仓库：

  git remote add origin https://github.com/用户名/仓库名.git
  

6. 推送到 GitHub：

• 使用以下命令将本地仓库的内容推送到 GitHub：

  git push -u origin main 
  

  这里"main"是默认的分支，可以自行更改。
• 如果报错Failed to connect to 127.0.0.1 port 7890 after 2076 ms: Couldn’t connect to server，解决方法见8.3。
• 如果报错error: src refspec main does not match any，解决方法见8.4

7. 查看 GitHub 仓库：

• 刷新 GitHub 仓库页面，你将看到上传的文件。

8. 报错及解决方法：

8.1. error: remote origin already exists.

这个错误表明在添加远程仓库时，origin 这个名称已经被使用了。这通常是因为你之前已经添加了一个名为 origin 的远程仓库。
以下是解决方法的步骤：

1. 先删除之前的 origin 远程仓库：

   git remote remove origin
   

2. 然后再添加新的远程仓库：

   git remote add origin git@github.com:Github用户名/仓库名.git
   git push -u origin main
   

8.2. error: failed to push some refs

这个错误提示说明远程仓库（GitHub 上的仓库）包含你本地仓库所没有的提交。为了解决这个问题，你需要拉取远程仓库的更改并将它们合并到你的本地分支中，然后再推送。

以下是解决方法的步骤：

1. 拉取远程仓库的更改：

   git pull origin main
   

   这将拉取远程仓库 main 分支的更改并尝试将它们合并到你的本地 main 分支。

2. 提交解决冲突后的更改：

   git add .
   git commit -m "Resolve merge conflict"
   

3. 再次尝试推送：

   git push origin main
   

8.3. error: Failed to connect to 127.0.0.1 port 7890

这可能是由于某些网络代理或配置问题导致的。
法一：换一种连接方式，使用 SSH 连接。
法二：尝试清除代理。（20240307补）

以下是使用 SSH 连接的步骤：

1. 生成 SSH 密钥：

   ssh-keygen -t rsa -b 4096 -C "GitHub 注册时使用的邮箱"
   

2. 将 SSH 密钥添加到 SSH 代理：

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_rsa
   

3. 复制SSH 公钥：

   cat ~/.ssh/id_rsa.pub
   

4. 进入 SSH 设置页面：

   • 点击Github右上角的用户头像，选择 “Settings”。
   • 在左侧菜单中选择 “SSH and GPG keys”。

5. 添加新的 SSH 公钥：

   • 点击 “New SSH key” 或 “Add SSH key”。
   • 在 “Title” 字段中为密钥命名，可以是任意描述性的名称（例如 “My SSH”）。
   • 在 “Key” 字段中，粘贴你之前复制的 SSH 公钥内容。

6. 保存 SSH 公钥：

   • 点击 “Add SSH key” 或 “Add key” 完成添加。
   • 根据GitHub的提示完成验证。

7. 通过 SSH 添加远程仓库的步骤：

   git remote add origin git@github.com:用户名/仓库名.git
   

以下是清除代理的步骤（20240307补）：

1. 查看配置
   • win+R，输入cmd，回车，打开终端。

   git config --list  		# 查看后，输入q，退出
   

   • 找一找是不是有包含127.0.0.1的相关配置存在
2. 清除代理

   git config --global --unset http.proxy	
   git config --global --unset https.proxy
   

8.4.main分支不存在（20240418补）

1. 首先，查看本地仓库中有哪些分支：

   git branch
   

2. 如果 “main” 分支不存在，可以尝试切换到其他已存在的分支，或者创建一个新的 “main” 分支：

   git checkout -b main