Obsidian/工具学习/Git命令学习.md

Git 命令学习

适用环境：Windows + PowerShell。
学习目标：先掌握日常高频 Git 命令，再理解分支、远程协作、撤销回退和冲突解决。

1. Git 核心概念

Git 是一个分布式版本控制工具，用来记录代码或文档的每次变化。

最重要的是理解三个区域：

工作区 -> git add -> 暂存区 -> git commit -> 本地仓库

区域	含义	常见命令
工作区	你正在编辑的文件	git status、git diff
暂存区	准备提交的修改	git add、git restore --staged
本地仓库	已经形成版本记录的提交	git commit、git log

2. 初始化与基础配置

查看 Git 是否安装：

git --version

设置用户名和邮箱：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

查看配置：

git config --list

在当前目录初始化 Git 仓库：

git init

3. 日常提交流程

查看当前状态：

git status

把指定文件加入暂存区：

git add 文件名

把当前目录所有修改加入暂存区：

git add .

提交修改：

git commit -m "提交说明"

查看提交历史：

git log
git log --oneline

推荐日常流程：

git status
git add .
git commit -m "说明本次修改"
git log --oneline

4. 查看修改差异

查看工作区中还没有暂存的修改：

git diff

查看已经 git add 但还没有提交的修改：

git diff --staged

查看某个文件的修改：

git diff -- 文件名

查看提交历史图：

git log --oneline --graph --all

5. 分支命令

查看分支：

git branch

创建分支：

git branch dev

切换分支：

git switch dev

创建并切换分支：

git switch -c feature/login

合并分支：

git switch main
git merge feature/login

删除已经合并的分支：

git branch -d feature/login

强制删除分支：

git branch -D feature/login

注意：-D 会强制删除分支，使用前要确认该分支不再需要。

6. 远程仓库命令

克隆远程仓库：

git clone 仓库地址

查看远程仓库地址：

git remote -v

添加远程仓库：

git remote add origin 仓库地址

首次推送本地 main 分支到远程：

git push -u origin main

后续推送：

git push

拉取远程更新并自动合并：

git pull

只获取远程更新，不自动合并：

git fetch

常见区别：

命令	作用
git fetch	获取远程变化，但不改当前工作分支
git pull	获取远程变化，并尝试合并到当前分支
git push	把本地提交推送到远程仓库

7. 撤销与回退

撤销工作区中某个文件的修改：

git restore 文件名

把文件从暂存区移回工作区：

git restore --staged 文件名

撤销上一次提交，但保留修改在暂存区：

git reset --soft HEAD~1

撤销上一次提交，修改回到工作区：

git reset --mixed HEAD~1

撤销上一次提交，并丢弃相关修改：

git reset --hard HEAD~1

生成一个新的反向提交，用来撤销某次提交：

git revert 提交ID

安全建议：

场景	推荐命令
只是撤销某个文件的未提交修改	git restore 文件名
已经提交但还没推送，想重新整理	git reset --soft HEAD~1
已经推送到远程，想撤销影响	git revert 提交ID
明确要丢弃所有修改	git reset --hard

高风险命令：git reset --hard 会丢弃修改，执行前必须确认没有重要内容。

8. 临时保存修改

当前工作做到一半，但需要先切换分支时，可以用 stash。

保存当前修改：

git stash

查看保存列表：

git stash list

恢复最近一次保存：

git stash pop

恢复但不删除保存记录：

git stash apply

删除某条保存记录：

git stash drop stash@{0}

9. 冲突解决

当两个人或两个分支修改了同一处内容，合并时可能出现冲突。

典型流程：

git pull

如果出现冲突，打开冲突文件，会看到类似内容：

<<<<<<< HEAD
当前分支的内容
=======
对方分支的内容
>>>>>>> branch-name

处理步骤：

1. 手动编辑文件，保留正确内容。
2. 删除 <<<<<<<、=======、>>>>>>> 标记。
3. 执行：

git add 冲突文件
git commit

10. 标签命令

标签常用于标记版本号。

查看标签：

git tag

创建标签：

git tag v1.0.0

创建带说明的标签：

git tag -a v1.0.0 -m "发布 v1.0.0"

推送标签：

git push origin v1.0.0

推送所有标签：

git push origin --tags

11. .gitignore

.gitignore 用来声明哪些文件不需要提交到 Git。

常见示例：

# 日志
*.log

# 系统文件
Thumbs.db
.DS_Store

# 依赖目录
node_modules/

# 构建产物
dist/
build/

# 本地配置
.env
local.properties

如果文件已经被 Git 跟踪，后来再加入 .gitignore 不会自动生效，需要先取消跟踪：

git rm --cached 文件名

12. 常用排查命令

查看某个文件每一行是谁改的：

git blame 文件名

查看所有操作记录，包括 reset 前的记录：

git reflog

查看某次提交详情：

git show 提交ID

查看当前分支与远程分支差异：

git status
git log --oneline --graph --decorate --all

13. 推荐学习练习

建议新建一个专门练习目录，例如：

mkdir git-practice
cd git-practice
git init

练习 1：第一次提交

New-Item readme.md
Add-Content readme.md "# Git Practice"
git status
git add readme.md
git commit -m "初始化练习文档"
git log --oneline

练习 2：查看差异

Add-Content readme.md "第一次修改"
git diff
git add readme.md
git diff --staged
git commit -m "更新练习文档"

练习 3：创建分支

git switch -c feature/note
Add-Content readme.md "feature 分支内容"
git add readme.md
git commit -m "添加 feature 分支内容"
git switch main
git merge feature/note

练习 4：撤销修改

Add-Content readme.md "这是一行想撤销的内容"
git status
git restore readme.md
git status

练习 5：查看历史图

git log --oneline --graph --all

14. 日常速查表

目标	命令
查看状态	git status
查看未暂存差异	git diff
查看已暂存差异	git diff --staged
添加文件	git add 文件名
添加全部修改	git add .
提交	git commit -m "说明"
查看历史	git log --oneline
创建并切换分支	git switch -c 分支名
切换分支	git switch 分支名
合并分支	git merge 分支名
拉取远程更新	git pull
推送到远程	git push
临时保存修改	git stash
恢复临时保存	git stash pop
撤销工作区修改	git restore 文件名
取消暂存	git restore --staged 文件名
查看完整操作记录	git reflog

15. 学习优先级

第一优先级：

• git status
• git add
• git commit
• git log
• git diff

第二优先级：

• git branch
• git switch
• git merge
• git pull
• git push

第三优先级：

• git restore
• git reset
• git revert
• git stash
• git reflog

16. 容易踩坑的点

• git add . 会把当前目录下所有修改都加入暂存区，提交前要用 git status 和 git diff --staged 检查。
• git reset --hard 会丢弃修改，重要内容可能找不回来。
• 已经推送到远程的提交，优先用 git revert，不要随便改公共历史。
• 拉取远程更新前，最好先确认本地是否有未提交修改。
• 合并冲突时，必须删除冲突标记后再提交。
• .gitignore 只对未被 Git 跟踪的新文件自动生效。

17. 一句话记忆

status 看状态，diff 看变化，add 进暂存，commit 成版本；
branch 管分支，switch 换分支，merge 合分支；
pull 拉远程，push 推远程；
restore 撤文件，reset 改历史，revert 安全反做，reflog 救现场。