Git使用教程（含常见问题解决）

适用于Windows/macOS/Linux，适合将本地项目上传到Gitee或GitHub。

一、Git基础操作

1. 本地仓库初始化

git init

在当前文件夹中生成.git隐藏文件，标记为Git仓库。

2. 添加文件并提交

git add .
git commit -m "初始提交"

将当前目录下所有文件添加并提交。add后面也可添加特定文件，仅对特定文件添加提交。

3. 添加远程仓库

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

4. 推送本地仓库到远程

git push -u origin master

master 为分支名，如果使用main需要根据需要修改。

二、可能遇到的问题及解决方法

问题1. 推送时报错 src refspec master does not match any

原因：

没有做任何提交，就进行了推送。

解决方法：

先进行一次提交，再进行推送

git add .
git commit -m "初始提交"
git push -u origin master

问题2. [rejected] master->master(fetch first)

原因：

远程仓库不是空的（例如已经存在README.md），所以不能直接推送

解决方法：

方法1：合并远程内容（推荐使用，先pull再push）

git pull origin master --rebase
git push origin master

方法2：强制推送（覆盖远程内容)

git push -u origin master --force

问题3： error: RPC failed; HTTP 413

原因：

推送的文件太大，超过了Gitee/GitHub的限制，可能你把数据集文件也一并上传了。

解决方法：

把大文件上传到网盘中

问题4：链接GitHub超时/无法访问

原因：

GitHub在国内部分网络环境下被限制

解决方法：

使用代理工具

三、常用其它命令

检查分支：

git branch

重命名分支：

git branch -m old_name new_name

删除远程分支：

git push origin --delete branch_name