716 字

4 分钟

Git 基础教程：新建分支、提交更改、推送代码

2025-12-01

git

笔记

📚 Git 基础教程：新建分支、提交更改、推送代码#

适用场景：你在本地开发新功能或修复 Bug，希望在独立分支上工作，完成后推送到远程仓库（如 GitHub、GitLab）。

✅ 前提条件#

已安装 Git

已克隆项目到本地（或已初始化仓库）

1
git clone https://github.com/your-username/your-repo.git
2
cd your-repo

🔁 步骤一：同步最新代码（可选但推荐）#

确保你的 main（或 master）分支是最新的：

1
# 切换到主分支
2
git checkout main
3

4
# 拉取最新代码
5
git pull origin main

💡 如果你使用的是 master 分支，请将 main 替换为 master。

🌿 步骤二：新建并切换到新分支#

1
# 创建并切换到新分支（推荐命名：功能/修复描述）
2
git checkout -b feat/add-login-page

-b 表示“创建新分支”

分支命名建议：

feat/xxx：新功能

fix/xxx：Bug 修复

docs/xxx：文档更新

chore/xxx：杂项（如依赖升级）

✅ 执行后，你就在新分支上了！

验证当前分支：

1
git branch
2
# 输出中带 * 的是当前分支

✏️ 步骤三：修改文件#

在编辑器中修改或添加文件，例如：

1
echo "# New Feature" > login.md

📤 步骤四：提交更改#

1. 查看更改状态#

1
git status

你会看到 login.md 被标记为 “untracked”（未跟踪）。

2. 将文件加入暂存区（Staging Area）#

1
git add login.md
2
# 或添加所有更改：
3
# git add .

3. 提交到本地仓库#

1
git commit -m "feat: add login page draft"

✅ 提交信息规范建议：

使用动词开头（add, fix, update, remove）

简洁明确

可加上类型前缀：feat:, fix:, docs:, style:, refactor: 等

☁️ 步骤五：推送分支到远程仓库#

第一次推送时，需要设置上游分支（upstream）：

1
git push -u origin feat/add-login-page

-u（或 --set-upstream）会将本地分支与远程分支关联

之后只需 git push 即可推送

成功后，你可以在 GitHub/GitLab 上看到这个新分支！

🔁 后续：继续开发并多次提交#

如果你继续修改：

1
# 修改文件...
2
git add .
3
git commit -m "feat: improve login UI"
4
git push  # 因为已设置 upstream，直接 push 即可

🔄 同步主分支更新（可选）#

如果在开发过程中，main 分支有新提交，你可以合并进来避免冲突：

1
# 切回主分支，拉取最新
2
git checkout main
3
git pull origin main
4

5
# 切回你的分支，合并 main
6
git checkout feat/add-login-page
7
git merge main
8
# 或使用 rebase（更干净的历史）：
9
# git rebase main

🎯 完整命令流程总结#

1
# 1. 确保主分支最新
2
git checkout main
3
git pull origin main
4

5
# 2. 创建并切换分支
6
git checkout -b feat/your-feature
7

8
# 3. 修改文件...
9

10
# 4. 提交更改
11
git add .
12
git commit -m "feat: describe your change"
13

14
# 5. 推送到远程
15
git push -u origin feat/your-feature

❓常见问题#

Q：如何查看所有分支？#

1
git branch -a

Q：如何删除本地分支？#

1
git branch -d feat/your-feature

Q：如何删除远程分支？#

1
git push origin --delete feat/your-feature

Q：提交错了怎么办？#

修改上次提交（未 push）：

1
git add .
2
git commit --amend -m "new message"

Git 基础教程：新建分支、提交更改、推送代码

https://fuwari.vercel.app/posts/git/git_create_new/

作者

江湖一条鱼

发布于

2025-12-01

许可协议

CC BY-NC-SA 4.0

Git 分支开发速查命令卡片（Cheat Sheet）

1

📚 Git 基础教程：新建分支、提交更改、推送代码