软件工程实践一：Git 使用教程（含分支与 Gitee）

IsayIsee Lv3
  2026-04-07 15:14:13 2026-04-07 15:14:13 创建   2026-05-18 14:26 2026-05-18 14:26 更新      

文章来源说明：

  • 作者： [xuan]
  • 发布平台： [Xuan’s blog]
  • 原链接： https://blog.ybyq.wang/archives/1095.html
  • 发布时间： [2025-09-10]
  • 转载用途： 仅供学习和技术交流

    版权归原作者所有，本文仅做整理和分享之用。

软件工程实践一：Git 使用教程（含分支与 Gitee）

目标

  • 掌握 Git 基础概念与常用命令：仓库、提交、暂存区、分支
  • 熟悉常见工作流：创建/切换分支、合并、变基、解决冲突
  • 了解远程协作：添加远程、推送/拉取、使用 Gitee（码云）

提示：Windows 可使用 Git Bash 或 PowerShell（需先安装 Git for Windows）。

一、快速上手

1. Windows 安装 Git

  • 下载与安装

  • 验证与基础配置

1
2
3
4
5
6
7
8
9
10
11
git --version
which bash
# 基本配置（签名和默认分支）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global color.ui auto
# Windows：换行符自动转换（跨平台推荐）
git config --global core.autocrlf true
# 可选：将 VS Code 设为默认编辑器
git config --global core.editor "code --wait"
  • 账号与 Gitee 绑定（推荐使用个人访问令牌）
1
2
3
4
5
6
7
# 方式一：账号密码（不推荐）
# 推送时按提示输入 Gitee 用户名和密码

# 方式二：个人访问令牌（推荐，更安全）
# 1. 登录 Gitee → 个人设置 → 私人令牌
# 2. 创建令牌并勾选需要的权限（如 projects）
# 3. 推送时用户名填 Gitee 用户名，密码填该令牌

2. 初始化 / 克隆

1
2
3
4
5
# 初始化本地仓库（在当前目录创建 .git）
git init

# 克隆远程仓库
git clone <repo-url>

二、核心概念速览

  • 工作区（Working Directory）：你看到的文件
  • 暂存区（Staging Area）：下次提交的快照
  • 本地仓库（Local Repository）：提交历史（HEAD 指向的分支）
  • 远程仓库（Remote）：如 origin（GitHub/Gitee 等）

三、常用命令清单

1) 查看状态与差异

1
2
3
git status                  # 当前状态
git diff                    # 工作区 vs 暂存区
git diff --staged           # 暂存区 vs 最近一次提交

2) 添加与提交

1
2
3
4
5
6
git add <file>              # 添加到暂存区
git add .                   # 添加所有修改
git commit -m "feat: add user api"  # 提交

# 修改上一条提交信息（未推送时）
git commit --amend -m "fix: correct message"

3) 历史与回溯

1
2
3
4
git log --oneline --graph --decorate --all

# 查看某次提交内容
git show <commit>

4) 撤销与恢复（Git 2.23+ 推荐新命令）

1
2
3
4
5
6
7
8
9
10
11
12
# 丢弃工作区更改（小心使用）
git restore <file>

# 从暂存区移除（保留工作区修改）
git restore --staged <file>

# 还原一个提交（生成反向提交）
git revert <commit>

# 重置分支到某提交（危险，谨慎）
# --soft: 仅移动 HEAD；--mixed: 重置暂存区；--hard: 丢弃工作区
git reset --mixed <commit>

5) 忽略文件

创建 .gitignore：

1
2
3
4
5
6
7
# Java/IDE 示例
/target/
*.class
*.log
.idea/
*.iml
.DS_Store

四、分支与合并（Branch & Merge）

1) 创建与切换

1
2
3
4
# 创建并切换到新分支
git switch -c feature/login
# 在已有分支间切换
git switch main

2) 更新主干与合并

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 将 feature/login 合并到 main
git switch main
git merge feature/login

# 同步主干最新（需先配置远程）
git fetch origin
git switch main
git pull --rebase origin main

# 回到功能分支并合并主干变更
git switch feature/login
# 策略 1：合并提交（保留分叉历史）
git merge main --no-ff -m "merge main into feature/login"
# 策略 2：变基（历史更线性）
# 说明：将当前分支的提交"挪到" main 最新之后，减少合并提交
git rebase main

3) 推送与合并回主干

1
2
3
4
5
6
7
# 首次推送功能分支并建立上游
git push -u origin feature/login

# 发起合并（建议 PR/MR 流程），或本地合并：
git switch main
git merge --no-ff feature/login -m "feat(login): implement basic login"
git push origin main

4) 解决冲突

1
2
3
4
5
6
# 冲突后，编辑冲突文件并标记已解决
git add <conflicted-files>
# 若在 rebase 流程：
git rebase --continue
# 若放弃 rebase：
git rebase --abort

5) 常见工作流

  • Git Flow：main + develop + feature/release/hotfix（适合版本节奏固定）
  • Trunk-Based：main + 短分支 + 小步快跑 + CI（多数团队推荐）

五、远程协作（Remote）

1) 添加与管理远程

1
2
3
4
5
git remote -v
# 添加远程别名 origin
git remote add origin <url>
# 修改远程地址
git remote set-url origin <new-url>

2) 获取与推送

1
2
3
git fetch origin                  # 仅拉取，不更新本地分支
git pull --rebase origin main     # 拉取并变基（历史更干净）
git push origin main              # 推送

3) 追踪分支（上游）

1
2
3
4
5
6
7
8
# 建立本地分支与远程上游的关联（首次）
git push -u origin feature/x
# 之后即可：
# git push
# git pull --rebase
# 如有冲突：
# git add .
# git rebase --continue 或 git merge --continue

六、Gitee（码云）使用

1) 创建仓库

  • 登录 Gitee，新建仓库，获取 HTTPS 或 SSH 地址

2) 使用账号密码或个人访问令牌（推荐）

1
2
3
4
5
# 方式一：账号密码（推送时按提示输入）
# 方式二：个人访问令牌（推荐）
#   1) Gitee 个人设置 → 私人令牌
#   2) 创建令牌并勾选权限（如 projects）
#   3) 推送时用户名=Gitee 用户名，密码=个人令牌

3) 绑定远程并推送（以 HTTPS 为例）

1
2
3
4
# 在已有本地仓库中添加 origin（Gitee）
git remote add origin https://gitee.com/<your-namespace>/<repo>.git
# 首次推送（设置上游）
git push -u origin main

4) 从 GitHub 迁移到 Gitee（镜像）

  • 方案 A：在 Gitee 仓库设置中使用”从 GitHub 导入仓库”
  • 方案 B：本地设置两个远程，手动推送
1
2
3
4
5
git remote add github git@github.com:<ns>/<repo>.git
git remote add gitee  https://gitee.com/<ns>/<repo>.git
# 推送全部分支与标签
git push gitee --all
git push gitee --tags

七、进阶：变基、挑拣、暂存与标签

1) 交互式变基（整理提交历史）

1
git rebase -i HEAD~5  # squash / fixup / reword / reorder

2) 挑拣（把某提交拷到当前分支）

1
git cherry-pick <commit>

3) 暂存（临时搁置工作）

1
2
3
git stash push -m "wip: refactor"
git stash list
git stash apply  # 或 pop

4) 标签（发布打标）

1
2
3
git tag v1.0.0
git tag -a v1.0.1 -m "hotfix"
git push origin --tags

八、常见问题速查

  • push 被拒绝：先 git fetch，再 git rebase origin/main 或开分支提 PR
  • Detached HEAD：git switch <branch> 回到分支；需要保存可新建分支 git switch -c temp
  • 误删文件：从最近提交恢复 git restore --source=HEAD -- <file>
  • 大文件入库：考虑 Git LFS；或加入 .gitignore 并清理历史
  • 行尾换行混乱：检查 core.autocrlf 设置；跨平台建议 true

九、实战练习：20 步从零到协作

场景：在本地新建项目 → 管理变更 → 分支开发 → 合并与解决冲突 → 连接远程并推送 → 打标签与回滚。命令可在 PowerShell 或 Git Bash 中执行。要求：提交信息使用中文，示例代码使用 Java。

1. 新建目录并初始化仓库

1
2
mkdir demo-git && cd demo-git
git init

2. 配置用户名邮箱（仅首次或需要覆盖时）

1
2
git config user.name "学生"
git config user.email "student@example.com"

3. 创建 README 并首次提交（中文提交信息）

1
2
3
echo "# Demo Git 项目" > README.md
git add README.md
git commit -m "初始化仓库并添加 README"

4. 新建 .gitignore 并提交

1
2
3
echo -e "/dist/\n*.log" > .gitignore
git add .gitignore
git commit -m ".gitignore：忽略构建产物和日志"

5. 创建 Java 主类并提交（App v1）

1
2
3
4
5
6
7
8
mkdir src
echo "public class App {" > src/App.java
echo "  public static void main(String[] args) {" >> src/App.java
echo "    System.out.println(\"v1\");" >> src/App.java
echo "  }" >> src/App.java
echo "}" >> src/App.java
git add src/App.java
git commit -m "新增 Java 主类 App（v1）"

6. 创建功能分支并切换

1
git switch -c feature/login

7. 在功能分支新增登录功能类（提交 1）

1
2
3
4
5
echo "public class AuthService {" > src/AuthService.java
echo "  public boolean login() { return true; }" >> src/AuthService.java
echo "}" >> src/AuthService.java
git add src/AuthService.java
git commit -m "登录功能：新增 AuthService，包含 login 方法"

8. 在功能分支完善登出功能（提交 2）

1
2
3
4
5
6
echo "public class AuthService {" > src/AuthService.java
echo "  public boolean login() { return true; }" >> src/AuthService.java
echo "  public boolean logout() { return true; }" >> src/AuthService.java
echo "}" >> src/AuthService.java
git add src/AuthService.java
git commit -m "登录功能：补充 logout 方法"

9. 切回主分支并做一次修复

1
2
3
4
5
6
7
8
9
git switch main
echo "public class App {" > src/App.java
echo "  public static void main(String[] args) {" >> src/App.java
echo "    System.out.println(\"v1\");" >> src/App.java
echo "    System.out.println(\"HOTFIX\");" >> src/App.java
echo "  }" >> src/App.java
echo "}" >> src/App.java
git add src/App.java
git commit -m "主分支修复：修正启动日志（HOTFIX）"

10. 将主干变更同步到功能分支（rebase，更线性）

1
2
git switch feature/login
git rebase main

11. 若出现冲突则解决并继续（无冲突可跳过）

1
2
3
# 编辑有冲突的文件，确认内容后：
git add .
git rebase --continue

12. 将功能分支合并回主干（无快进，保留记录）

1
2
git switch main
git merge --no-ff feature/login -m "合并 feature/login：登录功能完成"

13. 查看提交历史图

1
git log --oneline --graph --decorate --all

14. 创建发布标签（v1.0.0）

1
git tag -a v1.0.0 -m "首次发布版本"

15. 添加远程并首次推送（以 Gitee 为例）

1
2
git remote add origin https://gitee.com/<your-namespace>/<repo>.git
git push -u origin main

16. 推送功能分支与标签

1
2
git push -u origin feature/login
git push origin --tags

17. 创建新分支新增 Banner 类，并将提交挑拣到 main

1
2
3
4
5
6
7
8
git switch -c feature/banner
echo "public class Banner {" > src/Banner.java
echo "  public static void show() { System.out.println(\"BANNER\"); }" >> src/Banner.java
echo "}" >> src/Banner.java
git add src/Banner.java
git commit -m "新增 Banner 类：打印横幅"
git switch main
git cherry-pick feature/banner

18. 制造一个误提交并回退工作区/暂存区

1
2
3
4
5
6
echo "wrong" > tmp.txt
git add tmp.txt
# 发现误加：从暂存区移除，保留工作区
git restore --staged tmp.txt
# 丢弃工作区更改（小心）
git restore tmp.txt

19. 修改最近一次提交的提交信息，并升级 App 到 v2

1
2
3
4
5
6
7
8
9
10
echo "public class App {" > src/App.java
echo "  public static void main(String[] args) {" >> src/App.java
echo "    System.out.println(\"v1\");" >> src/App.java
echo "    System.out.println(\"v2\");" >> src/App.java
echo "  }" >> src/App.java
echo "}" >> src/App.java
git add src/App.java
git commit -m "升级主程序至 v2"
# 修正提交信息：
git commit --amend -m "App 升级：输出 v1 与 v2"

20. 回滚某次已推送的功能（生成反向提交，安全）

1
2
git revert HEAD
git push origin main

提示：

  • 如遇推送被拒绝，先执行 git fetch 与 git pull --rebase origin main 同步。
  • 在多人协作中，建议使用 Pull Request/Merge Request 进行代码评审与合并。
  • 标题: 软件工程实践一：Git 使用教程（含分支与 Gitee）
  • 作者: IsayIsee
  • 创建于 : 2026-04-07 15:14:13
  • 更新于 : 2026-05-18 14:00:26
  • 链接: https://blog.120528.xyz/2026/04/07/98a49658/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
目录
软件工程实践一：Git 使用教程（含分支与 Gitee）
  1. 软件工程实践一：Git 使用教程（含分支与 Gitee）
    1. 目标
    2. 一、快速上手
      1. 1. Windows 安装 Git
      2. 2. 初始化 / 克隆
    3. 二、核心概念速览
    4. 三、常用命令清单
      1. 1) 查看状态与差异
      2. 2) 添加与提交
      3. 3) 历史与回溯
      4. 4) 撤销与恢复（Git 2.23+ 推荐新命令）
      5. 5) 忽略文件
    5. 四、分支与合并（Branch & Merge）
      1. 1) 创建与切换
      2. 2) 更新主干与合并
      3. 3) 推送与合并回主干
      4. 4) 解决冲突
      5. 5) 常见工作流
    6. 五、远程协作（Remote）
      1. 1) 添加与管理远程
      2. 2) 获取与推送
      3. 3) 追踪分支（上游）
    7. 六、Gitee（码云）使用
      1. 1) 创建仓库
      2. 2) 使用账号密码或个人访问令牌（推荐）
      3. 3) 绑定远程并推送（以 HTTPS 为例）
      4. 4) 从 GitHub 迁移到 Gitee（镜像）
    8. 七、进阶：变基、挑拣、暂存与标签
      1. 1) 交互式变基（整理提交历史）
      2. 2) 挑拣（把某提交拷到当前分支）
      3. 3) 暂存（临时搁置工作）
      4. 4) 标签（发布打标）
    9. 八、常见问题速查
    10. 九、实战练习：20 步从零到协作