本地项目代码上传至Github的仓库

2025-04-23

总字数: 775字 | 阅读时长: 3分

1. 设置本地Git提交至Github的权限

1.1 设置Git用户名和邮箱

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

1.2 生成SSH密钥

ssh-keygen -t rsa -C "你的邮箱"

1.3 添加SSH密钥到Github

添加生成的id_rsa.pub文件中的公钥（用记事本打开全部复制）到github的setting –> SSH AND GPG KEY –> SSH keys

1.4 测试SSH连接

ssh -T git@github.com

如果出现以下信息，则表示SSH连接成功：

Hi Mizuki! You've successfully authenticated, but GitHub does not provide shell access.

如果出现以下信息，则表示SSH连接失败：

ssh: connect to host github.com port 22: Connection refused

这种情况，很可能是域名解析出现问题，可以通过ipconfig /flushdns 命令刷新DNS缓存,然后找到github服务器的ip地址，添加到hosts文件中，然后再次测试SSH连接。

140.82.114.4 github.com

2. 创建本地仓库

找到项目的文件夹，右键选择Git Bash Here，然后输入以下命令：

git init

初始化git仓库

git add .

把所有项目文件添加到提交暂存区

git commit -m "first commit"

把暂存区中的内容提交到仓库

3. 创建远程仓库

3.1 在Github上创建新仓库

登录Github账号
点击右上角”+”号，选择”New repository”
填写仓库名称、描述等信息
选择仓库类型(公开/私有)
点击”Create repository”完成创建

3.2 关联远程仓库

创建完成后,Github会显示仓库地址,复制SSH地址(以git@github.com开头的地址)
同步本地仓库到远程仓库

git remote add origin git@github.com:Mizuki-123/example.git

如果出现错误：fatal: remote origin already exists，则执行以下语句：

git remote rm origin
git remote add origin git@github.com:Mizuki-123/example.git

提交本地仓库到远程仓库

git push -u origin main

出现以下错误信息：

error: src refspec main does not match any
error: failed to push some refs to 'github.com:Mizuki-123/example.git'

这种情况，是因为远程仓库的默认分支是main，而本地仓库的默认分支是master，所以需要修改本地仓库的默认分支为main。

git branch -m master main

再次提交本地仓库到远程仓库

git push -u origin main

如果出现以下错误信息：

To github.com:Mizuki-123/example.git
 ! [rejected]        main -> main (non-fast-forward)
error: failed to push some refs to 'github.com:Mizuki-123/example.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. If you want to integrate the remote changes,
hint: use 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

这种情况，是因为远程仓库和本地仓库的提交历史不一致，需要先拉取远程仓库的最新提交，然后再提交本地仓库。

git pull origin main

如果远程仓库是新建的，里边或许有个README.md，就再没有其他文件，也可以使用以下命令强制提交覆盖远程仓库。

git push -u origin main --force

阅读量