Git 分支与提交操作：从本地仓库到 GitHub

一、Git 中的三个位置#

一次修改通常会经过三个位置：

1. 工作区：正在编辑的文件。
2. 暂存区：执行 git add 后，准备放入下一次提交的内容。
3. 提交历史：执行 git commit 后，形成一个可以被分支指向的版本节点。

常用检查命令是：

1
git status

它可以告诉我们哪些文件还没有加入暂存区、哪些文件已经暂存，以及当前处于哪个分支。

二、初始化仓库并完成第一次提交#

如果看到：

1
已初始化空的 Git 仓库于 /path/to/project/.git/

说明 .git 目录已经创建，但仓库还没有提交。此时先执行：

1
git add .
2
git commit -m "Initial commit"

git add . 会把当前目录下的修改加入暂存区；git commit 才会真正产生第一个提交。

也可以只提交某个文件夹：

1
git add folder-a/
2
git commit -m "更新 folder-a"

三、创建和切换分支#

1
git switch -c Quadruped-robot-investigation

1
git checkout -b Quadruped-robot-investigation

1
git branch Quadruped-robot-investigation

1
fatal: 不是一个有效的对象名：'master'

1
git switch Quadruped-robot-investigation

1
git checkout Quadruped-robot-investigation

1
git branch

1
git branch -m 新名称

1
git branch -M Quadruped-robot-investigation

四、不同文件夹能否推送到不同分支？#

可以选择性地提交不同文件夹：

1
git switch -c branch-a
2
git add folder-a/
3
git commit -m "更新 folder-a"
4

5
git switch main
6
git switch -c branch-b
7
git add folder-b/
8
git commit -m "更新 folder-b"

但要注意，Git 的分支不是“只存一个文件夹”。分支指向的是整个仓库的一组提交，每个提交描述的是整个项目在某一时刻的状态。git add folder-a/ 只是让这次提交主要包含 folder-a 的修改。

如果两个文件夹需要长期完全独立管理，通常更适合拆成两个仓库；如果只是希望同时在不同目录中开发不同分支，可以考虑 git worktree。

五、添加远程仓库#

第一次添加远程仓库：

1
git remote add origin https://github.com/33233dp/AHU.git

查看远程地址：

1
git remote -v

如果出现：

1
error: 远程 origin 已经存在。

说明远程仓库已经配置过了，不需要再次 add。如果地址写错，使用 set-url 修改：

1
git remote set-url origin https://github.com/33233dp/AHU.git

在终端中输入远程地址时要使用原始 URL，不要把 Markdown 链接写法 [文字](URL) 一起复制进去。

六、使用 SSH 推送到 GitHub#

本机有 SSH 密钥，并不代表 HTTPS 远程地址会自动使用 SSH。下面这个地址仍然是 HTTPS：

1
https://github.com/33233dp/AHU.git

如果希望使用 SSH，应把远程地址改成：

1
git remote set-url origin git@github.com:33233dp/AHU.git

测试 SSH 是否能连接 GitHub：

1
ssh -T git@github.com

如果密钥没有加入当前 SSH agent，可以尝试：

1
ssh-add ~/.ssh/id_ed25519

七、推送本地分支#

第一次把本地分支推送到远程时，使用 -u 建立跟踪关系：

1
git push -u origin Quadruped-robot-investigation

建立跟踪关系后，后续在该分支中通常可以直接使用：

1
git push
2
git pull

完整流程可以压缩成下面几步：

1
git init
2
git add .
3
git commit -m "Initial commit"
4
git switch -c Quadruped-robot-investigation
5
git remote add origin git@github.com:33233dp/AHU.git
6
git push -u origin Quadruped-robot-investigation

如果远程 origin 已经存在，就跳过 git remote add origin ...；如果它仍然是 HTTPS 地址，则先用 git remote set-url 改成 SSH 地址。

常见报错速查#

记住一句话即可：先提交，再建分支；先确认远程协议，再推送分支。