Git 基础：提交、分支与协作

Git 将修改组织为工作区、暂存区和提交，再通过远程仓库协作。本文按一次日常修改流程介绍命令，并说明冲突和历史恢复的边界。 这篇文章不讲复杂原理，直接按真实工作流来：创建仓库 → 提交代码 → 查看历史 → 分支协作 → 连接远程仓库。

先确认 Git 安装成功

git --version

看到版本号就说明安装好了。

新建一个 Git 仓库

进入你的项目目录后执行：

git init

这会在当前目录创建一个 .git 文件夹，表示这里已经是 Git 仓库。

查看文件状态（最重要的高频命令）

git status

你会经常用它来确认：

• 哪些文件被修改了
• 哪些文件准备提交
• 当前所在分支

把文件加入暂存区

git add 文件名

例如：

git add index.html

如果你想一次性添加所有变化：

git add .

提交代码（保存一个版本快照）

git commit -m "写清楚这次改了什么"

示例：

git commit -m "新增首页导航栏"

建议：提交信息尽量具体，不要只写“修改”“update”。

查看提交历史

git log

简洁一点可以用：

git log --oneline

它会一行显示一次提交，方便查版本记录。

连接远程仓库（GitHub/GitLab）

先添加远程地址：

git remote add origin 你的仓库地址

查看是否添加成功：

git remote -v

第一次推送到远程仓库

git push -u origin main

有些仓库默认分支叫 master，那就改成：

git push -u origin master

-u 的作用是建立本地分支和远程分支关联，后面你直接 git push 就行。

从远程拉取最新代码

git pull

等价于先抓取再合并，适合日常同步远程更新。

分支基础操作（团队协作必会）

查看分支

git branch

新建分支

git branch feature/login

切换分支

git checkout feature/login

或者（推荐新语法）：

git switch feature/login

新建并切换到分支

git checkout -b feature/login

或：

git switch -c feature/login

合并分支（先切回 main）

git checkout main
git merge feature/login

新手最常见错误与解决

错误 1：commit 前忘了 add

现象：提示没有可提交内容。 解决：先 git add . 再 git commit -m "..."。

错误 2：推送失败（分支名不对）

先看当前分支：

git branch --show-current

然后按实际分支推送：

git push -u origin 分支名

错误 3：拉取时报冲突

出现冲突后，打开冲突文件手动修改，修完后：

git add .
git commit -m "解决合并冲突"

一套新手日常操作流程（直接照抄）

# 1) 查看状态
git status

# 2) 添加修改
git add .

# 3) 提交
git commit -m "本次修改说明"

# 4) 拉取远程最新
git pull

# 5) 推送到远程
git push

结语

Git 不需要一口气学完所有命令。 对新手来说，可先按工作区、暂存区、提交与远程同步理解这些常用命令：

• git init
• git status
• git add
• git commit
• git log --oneline
• git remote -v
• git push
• git pull
• git branch
• git switch / git checkout
• git merge

工作区、暂存区与共享历史

提交前用 git diff 查看未暂存内容，git diff --cached 查看本次将提交的快照。git restore 会改变工作区或暂存区，使用前先确认源与目标；已经共享的提交通常通过 revert 生成反向提交，避免直接改写协作者依赖的历史。

合并冲突解决后，阅读最终 diff 并执行项目相关检查。Git 能验证文本合并完成，行为正确性仍需测试。遇到密钥进入历史时先撤销密钥，再按团队流程清理历史，删除当前文件不能撤销已泄露凭据。