很多人第一次接触 Git，都会觉得它有点绕。老实说，

明明只是写代码。 为什么还要 add 一下？ 为什么 commit 之后还要 push？为什么有了 Git，还要用 GitHub？为什么切换分支后文件会突然消失或者出现？为什么合并代码时会产生冲突？

这些问题很正常。因为 Git 不是一个“保存文件”的工具。它真正解决的是：如何记录项目的每一次变化，并让多人安全地协作开发同一个项目。

如果你只是一个人写一个很小的 demo，可能暂时感觉不到 Git 的价值。但只要项目稍微复杂一点，或者涉及多人协作、版本回退、代码备份、线上问题修复。Git 就会变成开发工作里关键的一部分。

这篇文章会沿着一个初学者最容易理解的路线，讲清楚 Git 和 GitHub 的基本概念、常用命令、分支协作、冲突处理还有 Pull Request 的基本流程。

. 为什么需要 Git：版本控制到底解决什么问题

在没有 Git 之前。很多人管理文件版本的方式可能是这样的：

project-finalproject-final-newproject-final-new-project-final-really-finalproject-final-client-old-version

这种方式看起来简单，但问题很多。

• 不知道哪些文件被改过；
• 无法确定每次改动发生的时间；
• 找不到是谁改的；
• 缺少改动原因的说明；
• 不清楚当前版本和旧版本之间的差异。其实，

Git 正是为了解决以上痛点而生的。话说回来，

它可以记录每一次变化。包括：

• 修改了哪些文件；按理说，
• 新增或删除了哪些内容；
• 谁提交了这次修改；
• 修改发生在什么时候；

Git 允许随时回到任意历史版本。

. Git 和 GitHub 不是一回事

Git 是本地版本控制工具

Git 安装在你的电脑上。只负责追踪本地项目中的文件变化，并把这些变化保存成一个个版本。你可以完全不使用远程网站，只在本地使用 Git：

git init
git add .
git commit -m "init project"

GitHub 是远程代码托管网站

GitHub 把本地仓库放到云端。并提供协作功能：

• 远程仓库；
• 多人协作；
• Pull Request；
• Issue；
• 代码审查；
• C​I/CD 自动化流程。

User Pain Point： 很多初学者把两者混为一谈，以致不清楚自己到底该先学哪一步。从记住来看，Git = 本地记录工具 | GitHub = 云端协作网站。

. Git 的主要结构：工作区、暂存区、本地仓库、远程仓库

工作区这方面。你真正写代码的地方

Pain Point： 修改后看不到任何提示，不知道是否已经被记录。话说回来，使用 git status 即可查看工作区状态。

暂存区的观点是，准备提交的临时区域

Pain Point： 为何不能直接提交？因为暂存区给你一次整理机会。只提交想要记录的内容，而不是所有改动都一起上车。

再看本地仓库，真正保存版本历史的地方

再看远程仓库，放在 GitHub 上的云端仓库

. 安装 Git 与初始化仓库

git --version # 检查是否安装成功
mkdir git-demo && cd git-demo
git init # 创建 .git 隐藏目录
# 此后所有操作都围绕 工作区 → 暂存区 → 本地仓库 → 远程仓库 的链路展开

. git status：查看当前项目状态

git status
# 会告诉你：
# - 哪些文件被修改、新增或删除
# - 哪些已经进入暂存区
# - 当前分支是否落后/领先远程分支
# - 是否还有未提交内容

. git add：把修改放入暂存区

添加指定文件

git add README.md # 只把 README 加入暂存区

添加当前目录及子目录所有修改

git add . # 最常用写法

添加整个仓库所有变化

git add -A # 或 git add --all
# 注意区别：
# - git add . → 只作用于当前目录及子目录
# - git add -A → 作用于整个仓库。更彻底

. git commit：把修改保存为一个版本

git commit -m "新增使用者登录接口"
# 好的提交信息示例：
# - 新增使用者登录接口
# - 修复商品列表分页错误
# - 调整移动端导航样式
# 不推荐：
# - update / fix / test 等模糊描述

. 第一次提交前：配置使用者名和邮箱

git config --global user.name "Your Name"
git config --global user.email ""
# 若仅针对当前项目，可去掉 --global 参数。

. git log：查看提交历史

git log # 完整日志
git log --oneline # 简洁单行模式。例如：
a1b2c3d 修复登录错误
e4f5g6h 新增使用者页面
i7j8k9l 初始化项目

. git reset 与 git restore：撤回或恢复

取消暂存

git reset # 把已 add 的内容退回工作区

撤销最近一次提交

git reset HEAD~ # 撤销最近一次 commit，但保留文件修改

Pain Point： 误操作导致代码丢失！慎用硬重置，

git reset --hard # 丢弃所有未提交改动，直接恢复到最新 commit 状态！务必确认无误后再执行，

Pain Point： 想放弃局部改动却不想重置整个工作区？

git restore file.txt # 恢复单个文件到最近一次 commit 状态
git restore . # 恢复整个工作区
git restore --staged file.txt # 仅取消暂存，不影响工作区内容

. git rm：删除文件并记录删除操作

# 常规删除后手动 add:
rm old.js && git add .
# 更直接的方法:
git rm old.js # 同时删除文件并加入暂存区
# 强制删除:
git rm -f conflict.js
# 仅停止追踪但保留本地副本:
git rm --cached secret.cfg
# 删除目录：
git rm -r old-folder/

. git clone：从 GitHub 克隆已有仓库

git clone https://github.com/username/repository.git # 下载并自动生成 .git 隐藏目录
# 区别于：
# git init → 本地新建空仓库
# git clone → 从远程复制完整历史
.

• push ：将本地 commit 推送到远程 分支。示例 :

  bash
  git push origin main
  
  
  
  li>
  li>  fetch ：拉取远程更新但不合并，让本地知道 “有什么新”。示例 :
  bash
  git fetch
  
  
  li>
  li>  pull ：等价于 fetch + merge，直接把新代码合并进当前分支。示例 :
  
  bash
  git pull
  
  
  
  
  
  ``