Git 新手通关指南 on acye's blog

Git 新手第一次使用：克隆、配置远程与首次推送

Wed, 01 Apr 2026 00:00:00 +0000

Git 新手第一次使用：克隆、配置远程与首次推送

1. 克隆仓库到本地

1
2

git clone https://github.com/username/repo.git
cd repo

2. 查看当前远程仓库地址

`1`	`git remote -v`

你会看到类似：

origin https://github.com/username/repo.git (fetch)
origin https://github.com/username/repo.git (push)

3. 设置或修改远程仓库地址

场景 A：已经有 `origin`，只想修改地址

`1`	`git remote set-url origin https://github.com/yourname/new-repo.git`

场景 B：没有 `origin`，第一次添加远程地址

`1`	`git remote add origin https://github.com/yourname/new-repo.git`

修改后再次检查：

`1`	`git remote -v`

4. 首次提交并推送

先把改动提交到本地仓库：

1
2

git add .
git commit -m "init project"

再首次推送到远程分支：

`1`	`git push -u origin main`

如果你的默认分支叫 master，则使用：

`1`	`git push -u origin master`

-u 的作用是建立本地分支和远程分支的追踪关系。设置后，后续可以直接使用：

1
2

git push
git pull

5. 常见检查命令

1
2
3

git status
git branch
git log --oneline

Git 工作流程与基本操作图解

Tue, 31 Mar 2026 10:00:00 +0000

Git 工作流程与基本操作图解

我们可以把 Git 的工作流程想象成一个写作业并交给老师的过程。

四个核心区域

1. 工作区（Working Directory）—— 你的书桌

这是你实际修改文件的地方。你在这里写代码、删删改改。

动作：你在这里编写了新功能或修复了 Bug。

2. 暂存区（Staging Area）—— 你的待邮寄篮子

当你觉得作业写得差不多了，你会把它放进一个篮子里，准备打包。

关键指令：git add
意义：告诉 Git，这些改动我确认要提交了，先帮我记着。

3. 本地仓库（Local Repository）—— 你的个人保险箱

你把篮子里的东西打包好，贴上标签（提交信息），锁进自己的保险箱。

关键指令：git commit
意义：改动正式成为了项目历史的一部分。即便你之后改乱了，也可以随时从这里找回。

4. 远程仓库（Remote）—— 老师的收件箱（如 GitHub/GitLab）

最后，你把保险箱里的代码通过网络发送给远程服务器，方便其他人查看或合作。

关键指令：git push
意义：备份代码，并与团队共享进度。

知识点说明

`git stash`（贮藏区）

作业写了一半，突然要改另一个急活，但又不想把没写完的作业提交。这时可以先用 stash 把代码藏进抽屉，等忙完再拿出来继续写（git stash pop）。

`git pull`（拉取）

看看老师（远程仓库）那里有没有别人交的新作业，直接同步到你的书桌上。

`git fetch` + `git merge`

先看看远程有什么更新（fetch），确认没问题后再合并（merge）到自己的代码里。

一句话总结

修改代码 -> add（放进篮子）-> commit（存入箱子）-> push（寄给远方）。

命令说明

1 克隆仓库

1
2

git clone https://github.com/username/repo.git
cd repo

2 创建新分支

`1`	`git checkout -b new-feature`

3 工作目录

在工作目录中进行代码编辑、添加新文件或删除不需要的文件。

4 暂存文件

1
2

git add filename
git add .

5 提交更改

`1`	`git commit -m "Add new feature"`

6 拉取最新更改

1
2

git pull origin main
git pull origin new-feature

7 推送更改

`1`	`git push origin new-feature`

8 创建 Pull Request（PR）

在 GitHub 或其他托管平台上创建 Pull Request，邀请团队成员进行代码审查。PR 合并后，你的更改就会合并到主分支。

9 合并更改

1
2
3

git checkout main
git pull origin main
git merge new-feature

10 删除分支

1
2

git branch -d new-feature
git push origin --delete new-feature

解决master与开发分支代码不一致,手把手教你同步分支

Tue, 13 Jan 2026 10:30:00 +0800

【Git 新手通关指南】解决 master 与开发分支代码不一致，手把手教你同步分支

作为 Git 新手，刚接触分支管理时大概率会遇到这个问题：本地master主分支和自己创建的z1开发分支代码不一样了，该怎么同步？为什么不能直接在master分支改代码？这篇文章用最通俗的话+一步步实操，帮你彻底搞懂！

一、先搞懂：master 和开发分支的“分工”（新手先记牢）

在团队协作或个人开发中，Git 分支有明确的“职责划分”，这是解决分支同步问题的基础：

master（主分支）：可以理解为项目的“正式版”，是稳定、可上线的代码版本，绝对不能随便改；
z1（开发分支）：你自己的“工作版”，所有开发、修改、调试都在这个分支做，相当于“草稿纸”，改乱了也不影响主分支。

所谓“同步代码”，本质就是把master分支的最新内容，整合到你的z1开发分支里，让两个分支的代码保持一致，同时又不破坏master的稳定性。

二、核心操作：同步 master 与 z1 分支的完整步骤

假设你已经克隆了仓库（git clone https://gitee.com/yigen1981/test.git），且创建了z1分支（git branch z1），现在要解决两个分支代码不一致的问题，按以下步骤来，一步都不能错！

前置准备

打开本地仓库对应的终端（Git Bash/CMD/终端都可以），确保你在仓库根目录下。

步骤 1：拉取远程最新代码（避免合并出错）

先把云端（Gitee/GitHub）的所有分支最新代码拉到本地，防止合并时因为本地代码过时出问题：

`1`	`git pull`

✅ 新手解读：这个命令相当于“刷新”本地代码，让你的master和z1都先同步云端的最新版本。

步骤 2：切换到 z1 开发分支（核心！必须先切）

所有操作都要在z1分支做，先确认并切换到z1：

# 切换到z1分支
git checkout z1
# 可选：检查当前分支（带*的就是当前分支，确保是z1）
git branch

✅ 新手解读：如果直接在master分支操作，相当于直接改“正式版”，风险极高，这是新手最容易踩的坑！

步骤 3：合并 master 代码到 z1（同步的核心）

执行合并命令，把master的最新代码整合到z1：

`1`	`git merge master`

✅ 新手解读：这个命令的意思是“把 master 的最新内容，合并到我当前所在的 z1 分支”，合并后 z1 就包含了 master 的所有代码，实现同步。

❌ 常见问题：如果合并时提示“冲突（conflict）”，比如“Auto-merging xxx.txt”“CONFLICT (content)”，别慌！这是因为同一个文件在master和z1里改了不同内容，Git 不知道该保留哪个，需要手动解决：

打开提示冲突的文件，会看到类似这样的标记：

<<<<<<< HEAD （这是z1分支的内容）
我在z1分支改的内容
======= （分隔线，两边是不同分支的内容）
别人在master分支改的内容
>>>>>>> master （这是master分支的内容）

删除这些标记（<<<<<<</=======/>>>>>>>），保留你需要的内容（比如保留最新的、正确的内容）；
保存文件，回到终端继续下一步。

步骤 4：提交合并后的代码并推到云端

合并完成（冲突解决后），要把同步后的代码保存并上传到云端的z1分支：

# 1. 把所有改动的文件加入“待提交清单”（.代表所有文件）
git add .
# 2. 保存改动并加备注（备注要清晰，新手别乱写）
git commit -m "合并master分支代码，同步最新内容"
# 3. 把本地z1的代码推到云端z1分支（关键！不然云端代码还是旧的）
git push origin z1

✅ 新手解读：这三步相当于“保存草稿 → 给草稿写备注 → 把草稿上传到云端”，确保你的修改不会丢。

三、关键原则：为什么绝对不能在 master 分支提交代码？

新手最容易犯的错就是直接在master分支改代码、提交，这是严格禁止的，原因很简单：

保护主分支稳定性：master是正式版代码，直接修改可能导致项目运行出错，甚至影响整个团队；
符合分支管理规范：所有开发工作都在开发分支（如 z1）完成，确认没问题后，再由负责人统一合并到master；
避免代码混乱：如果多人都直接改master，很容易出现代码冲突无法解决，最后整个项目代码乱套。

四、完整流程复盘（新手直接抄）

把所有步骤串起来，形成可直接复制的操作流：

# 1. 拉取远程最新代码
git pull
# 2. 切换到z1分支
git checkout z1
# 3. 合并master代码到z1
git merge master
# 4. 解决冲突（如果有）→ 保存文件
# 5. 提交并推送
git add .
git commit -m "合并master分支，同步代码"
git push origin z1

五、新手总结

分支同步的核心逻辑：切换到开发分支（z1）→ 合并主分支（master）→ 提交推送，始终围绕开发分支操作；
绝对禁忌：不在master分支做任何开发、提交操作，保护主分支的稳定性；
遇到冲突别慌：冲突是 Git 的正常提示，手动删除冲突标记、保留正确内容即可，合并后一定要推送代码到云端。

Git 新手通关指南 on acye's blog

Git 新手第一次使用：克隆、配置远程与首次推送

Git 新手第一次使用：克隆、配置远程与首次推送

1. 克隆仓库到本地

2. 查看当前远程仓库地址

3. 设置或修改远程仓库地址

场景 A：已经有 origin，只想修改地址

场景 B：没有 origin，第一次添加远程地址

4. 首次提交并推送

5. 常见检查命令

Git 工作流程与基本操作图解

Git 工作流程与基本操作图解

四个核心区域

1. 工作区（Working Directory）—— 你的书桌

2. 暂存区（Staging Area）—— 你的待邮寄篮子

3. 本地仓库（Local Repository）—— 你的个人保险箱

4. 远程仓库（Remote）—— 老师的收件箱（如 GitHub/GitLab）

知识点说明

git stash（贮藏区）

git pull（拉取）

git fetch + git merge

一句话总结

命令说明

1 克隆仓库

2 创建新分支

3 工作目录

4 暂存文件

5 提交更改

6 拉取最新更改

7 推送更改

8 创建 Pull Request（PR）

9 合并更改

10 删除分支

解决master与开发分支代码不一致,手把手教你同步分支

【Git 新手通关指南】解决 master 与开发分支代码不一致，手把手教你同步分支

一、先搞懂：master 和开发分支的“分工”（新手先记牢）

二、核心操作：同步 master 与 z1 分支的完整步骤

前置准备

步骤 1：拉取远程最新代码（避免合并出错）

步骤 2：切换到 z1 开发分支（核心！必须先切）

步骤 3：合并 master 代码到 z1（同步的核心）

步骤 4：提交合并后的代码并推到云端

三、关键原则：为什么绝对不能在 master 分支提交代码？

四、完整流程复盘（新手直接抄）

五、新手总结

场景 A：已经有 `origin`，只想修改地址

场景 B：没有 `origin`，第一次添加远程地址

`git stash`（贮藏区）

`git pull`（拉取）

`git fetch` + `git merge`