Git 首次工程搭建指南（一）

一、Git 基于本地分支操作指南

---

1. 创建远程分支并关联本地分支

# 方式1：先创建本地分支，再推送到远程

git checkout -b feature/new-feature  # 创建本地分支
git push -u origin feature/new-feature  # 推送到远程并关联（先给origin起别名）

# 方式2：基于远程分支直接创建本地分支

git fetch origin  # 更新远程分支信息
git checkout -b feature/new-feature origin/main  # 基于origin/main创建并关联
# 或简化写法：
git checkout -t origin/已有远程分支名  # 创建同名本地分支并跟踪

2. 验证分支关联

git branch -vv  # 查看本地分支与远程分支的关联关系

3. 日常操作

git push  # 推送本地更新到远程
git pull  # 拉取远程更新到本地
git pull --rebase  # 推荐：使用变基保持线性提交历史

4. 删除分支

git branch -d feature/new-feature  # 删除本地分支
git push origin --delete feature/new-feature  # 删除远程分支

二、Git 基于远程分支操作指南

1. 克隆仓库

作用：将远程仓库复制到本地
命令：
git clone <远程仓库URL> [本地目录名]

示例：

git clone https://github.com/example/repo.git
git clone https://github.com/example/repo.git my-project

补充：
- 克隆指定分支：git clone -b <分支名> <URL>
- 克隆到空目录：

  git init
  git remote add origin <URL>
  git fetch
  git checkout -b <分支名> origin/<分支名>

2. 创建分支

作用：在本地创建新分支
命令：
git branch <新分支名>
git checkout -b <新分支名>
git checkout -b <新分支名> <远程分支名>

示例：

git checkout -b feature/add-login
git checkout -b fix/bug-123 origin/main

补充：
- 查看分支：git branch / git branch -r / git branch -a
- 删除分支：git branch -d <分支名> / git branch -D <分支名>

3. 切换分支

作用：在不同分支间切换
命令：
git checkout <分支名>
git switch <分支名>

示例：

git checkout main
git switch -c new-feature

补充：
- 切换到上一个分支：git checkout - / git switch -
- 恢复文件：git checkout <分支名> -- <文件名>

4. 合并分支

作用：将一个分支的修改整合到另一个分支
命令：
git merge <源分支>
git rebase <目标分支>

git fetch origin  # 拉取远程分支信息
git checkout 远程新分支名  # 切换到该分支（会自动创建本地跟踪分支）
git remote show origin  # 查看远程仓库分支列表，确认 origin/test 存在

示例：

git checkout main
git merge feature
或
git checkout feature
git rebase main

补充：
- 解决冲突：编辑冲突文件后 git add <文件> 和 git commit
- 合并策略：
  git merge --no-ff <分支>
  git rebase -i <分支>

5. 暂存提交代码

作用：临时保存未提交的修改
命令：
git stash
git stash list
git stash apply
git stash drop
git stash pop

示例：

git stash
git checkout main
...处理main分支...
git checkout feature
git stash pop

补充：
- 命名暂存：git stash save "描述信息"
- 应用指定暂存：git stash apply stash@{2}
- 删除所有暂存：git stash clear

6. 其他常用操作

查看状态与历史：
git status
git log
git log --oneline --graph

远程仓库操作：
git remote -v                 查看本地仓库关联的远程仓库信息
git remote add 别名 URL       添加远程仓库并指定别名
git remote add origin https://jihulab.com/mystudio/myproject.git
git push -u origin 分支名            将本地分支推送到远程仓库，并关联上游分支
git pull --rebase                  拉取远程分支更新，并使用 rebase 方式合并（替代默认的 merge）

撤销与修改：
git reset HEAD <文件>
git checkout -- <文件>
git commit --amend