545 lines
8.8 KiB
Markdown
545 lines
8.8 KiB
Markdown
# Git 命令学习
|
|
|
|
> 适用环境：Windows + PowerShell。
|
|
> 学习目标：先掌握日常高频 Git 命令，再理解分支、远程协作、撤销回退和冲突解决。
|
|
|
|
## 1. Git 核心概念
|
|
|
|
Git 是一个分布式版本控制工具，用来记录代码或文档的每次变化。
|
|
|
|
最重要的是理解三个区域：
|
|
|
|
```text
|
|
工作区 -> git add -> 暂存区 -> git commit -> 本地仓库
|
|
```
|
|
|
|
| 区域 | 含义 | 常见命令 |
|
|
|---|---|---|
|
|
| 工作区 | 你正在编辑的文件 | `git status`、`git diff` |
|
|
| 暂存区 | 准备提交的修改 | `git add`、`git restore --staged` |
|
|
| 本地仓库 | 已经形成版本记录的提交 | `git commit`、`git log` |
|
|
|
|
## 2. 初始化与基础配置
|
|
|
|
查看 Git 是否安装：
|
|
|
|
```powershell
|
|
git --version
|
|
```
|
|
|
|
设置用户名和邮箱：
|
|
|
|
```powershell
|
|
git config --global user.name "你的名字"
|
|
git config --global user.email "你的邮箱"
|
|
```
|
|
|
|
查看配置：
|
|
|
|
```powershell
|
|
git config --list
|
|
```
|
|
|
|
在当前目录初始化 Git 仓库：
|
|
|
|
```powershell
|
|
git init
|
|
```
|
|
|
|
## 3. 日常提交流程
|
|
|
|
查看当前状态：
|
|
|
|
```powershell
|
|
git status
|
|
```
|
|
|
|
把指定文件加入暂存区：
|
|
|
|
```powershell
|
|
git add 文件名
|
|
```
|
|
|
|
把当前目录所有修改加入暂存区：
|
|
|
|
```powershell
|
|
git add .
|
|
```
|
|
|
|
提交修改：
|
|
|
|
```powershell
|
|
git commit -m "提交说明"
|
|
```
|
|
|
|
查看提交历史：
|
|
|
|
```powershell
|
|
git log
|
|
git log --oneline
|
|
```
|
|
|
|
推荐日常流程：
|
|
|
|
```powershell
|
|
git status
|
|
git add .
|
|
git commit -m "说明本次修改"
|
|
git log --oneline
|
|
```
|
|
|
|
## 4. 查看修改差异
|
|
|
|
查看工作区中还没有暂存的修改：
|
|
|
|
```powershell
|
|
git diff
|
|
```
|
|
|
|
查看已经 `git add` 但还没有提交的修改：
|
|
|
|
```powershell
|
|
git diff --staged
|
|
```
|
|
|
|
查看某个文件的修改：
|
|
|
|
```powershell
|
|
git diff -- 文件名
|
|
```
|
|
|
|
查看提交历史图：
|
|
|
|
```powershell
|
|
git log --oneline --graph --all
|
|
```
|
|
|
|
## 5. 分支命令
|
|
|
|
查看分支：
|
|
|
|
```powershell
|
|
git branch
|
|
```
|
|
|
|
创建分支：
|
|
|
|
```powershell
|
|
git branch dev
|
|
```
|
|
|
|
切换分支：
|
|
|
|
```powershell
|
|
git switch dev
|
|
```
|
|
|
|
创建并切换分支：
|
|
|
|
```powershell
|
|
git switch -c feature/login
|
|
```
|
|
|
|
合并分支：
|
|
|
|
```powershell
|
|
git switch main
|
|
git merge feature/login
|
|
```
|
|
|
|
删除已经合并的分支：
|
|
|
|
```powershell
|
|
git branch -d feature/login
|
|
```
|
|
|
|
强制删除分支：
|
|
|
|
```powershell
|
|
git branch -D feature/login
|
|
```
|
|
|
|
> 注意：`-D` 会强制删除分支，使用前要确认该分支不再需要。
|
|
|
|
## 6. 远程仓库命令
|
|
|
|
克隆远程仓库：
|
|
|
|
```powershell
|
|
git clone 仓库地址
|
|
```
|
|
|
|
查看远程仓库地址：
|
|
|
|
```powershell
|
|
git remote -v
|
|
```
|
|
|
|
添加远程仓库：
|
|
|
|
```powershell
|
|
git remote add origin 仓库地址
|
|
```
|
|
|
|
首次推送本地 `main` 分支到远程：
|
|
|
|
```powershell
|
|
git push -u origin main
|
|
```
|
|
|
|
后续推送：
|
|
|
|
```powershell
|
|
git push
|
|
```
|
|
|
|
拉取远程更新并自动合并：
|
|
|
|
```powershell
|
|
git pull
|
|
```
|
|
|
|
只获取远程更新，不自动合并：
|
|
|
|
```powershell
|
|
git fetch
|
|
```
|
|
|
|
常见区别：
|
|
|
|
| 命令 | 作用 |
|
|
|---|---|
|
|
| `git fetch` | 获取远程变化，但不改当前工作分支 |
|
|
| `git pull` | 获取远程变化，并尝试合并到当前分支 |
|
|
| `git push` | 把本地提交推送到远程仓库 |
|
|
|
|
## 7. 撤销与回退
|
|
|
|
撤销工作区中某个文件的修改：
|
|
|
|
```powershell
|
|
git restore 文件名
|
|
```
|
|
|
|
把文件从暂存区移回工作区：
|
|
|
|
```powershell
|
|
git restore --staged 文件名
|
|
```
|
|
|
|
撤销上一次提交，但保留修改在暂存区：
|
|
|
|
```powershell
|
|
git reset --soft HEAD~1
|
|
```
|
|
|
|
撤销上一次提交，修改回到工作区：
|
|
|
|
```powershell
|
|
git reset --mixed HEAD~1
|
|
```
|
|
|
|
撤销上一次提交，并丢弃相关修改：
|
|
|
|
```powershell
|
|
git reset --hard HEAD~1
|
|
```
|
|
|
|
生成一个新的反向提交，用来撤销某次提交：
|
|
|
|
```powershell
|
|
git revert 提交ID
|
|
```
|
|
|
|
安全建议：
|
|
|
|
| 场景 | 推荐命令 |
|
|
|---|---|
|
|
| 只是撤销某个文件的未提交修改 | `git restore 文件名` |
|
|
| 已经提交但还没推送，想重新整理 | `git reset --soft HEAD~1` |
|
|
| 已经推送到远程，想撤销影响 | `git revert 提交ID` |
|
|
| 明确要丢弃所有修改 | `git reset --hard` |
|
|
|
|
> 高风险命令：`git reset --hard` 会丢弃修改，执行前必须确认没有重要内容。
|
|
|
|
## 8. 临时保存修改
|
|
|
|
当前工作做到一半，但需要先切换分支时，可以用 `stash`。
|
|
|
|
保存当前修改：
|
|
|
|
```powershell
|
|
git stash
|
|
```
|
|
|
|
查看保存列表：
|
|
|
|
```powershell
|
|
git stash list
|
|
```
|
|
|
|
恢复最近一次保存：
|
|
|
|
```powershell
|
|
git stash pop
|
|
```
|
|
|
|
恢复但不删除保存记录：
|
|
|
|
```powershell
|
|
git stash apply
|
|
```
|
|
|
|
删除某条保存记录：
|
|
|
|
```powershell
|
|
git stash drop stash@{0}
|
|
```
|
|
|
|
## 9. 冲突解决
|
|
|
|
当两个人或两个分支修改了同一处内容，合并时可能出现冲突。
|
|
|
|
典型流程：
|
|
|
|
```powershell
|
|
git pull
|
|
```
|
|
|
|
如果出现冲突，打开冲突文件，会看到类似内容：
|
|
|
|
```text
|
|
<<<<<<< HEAD
|
|
当前分支的内容
|
|
=======
|
|
对方分支的内容
|
|
>>>>>>> branch-name
|
|
```
|
|
|
|
处理步骤：
|
|
|
|
1. 手动编辑文件，保留正确内容。
|
|
2. 删除 `<<<<<<<`、`=======`、`>>>>>>>` 标记。
|
|
3. 执行：
|
|
|
|
```powershell
|
|
git add 冲突文件
|
|
git commit
|
|
```
|
|
|
|
## 10. 标签命令
|
|
|
|
标签常用于标记版本号。
|
|
|
|
查看标签：
|
|
|
|
```powershell
|
|
git tag
|
|
```
|
|
|
|
创建标签：
|
|
|
|
```powershell
|
|
git tag v1.0.0
|
|
```
|
|
|
|
创建带说明的标签：
|
|
|
|
```powershell
|
|
git tag -a v1.0.0 -m "发布 v1.0.0"
|
|
```
|
|
|
|
推送标签：
|
|
|
|
```powershell
|
|
git push origin v1.0.0
|
|
```
|
|
|
|
推送所有标签：
|
|
|
|
```powershell
|
|
git push origin --tags
|
|
```
|
|
|
|
## 11. .gitignore
|
|
|
|
`.gitignore` 用来声明哪些文件不需要提交到 Git。
|
|
|
|
常见示例：
|
|
|
|
```gitignore
|
|
# 日志
|
|
*.log
|
|
|
|
# 系统文件
|
|
Thumbs.db
|
|
.DS_Store
|
|
|
|
# 依赖目录
|
|
node_modules/
|
|
|
|
# 构建产物
|
|
dist/
|
|
build/
|
|
|
|
# 本地配置
|
|
.env
|
|
local.properties
|
|
```
|
|
|
|
如果文件已经被 Git 跟踪，后来再加入 `.gitignore` 不会自动生效，需要先取消跟踪：
|
|
|
|
```powershell
|
|
git rm --cached 文件名
|
|
```
|
|
|
|
## 12. 常用排查命令
|
|
|
|
查看某个文件每一行是谁改的：
|
|
|
|
```powershell
|
|
git blame 文件名
|
|
```
|
|
|
|
查看所有操作记录，包括 reset 前的记录：
|
|
|
|
```powershell
|
|
git reflog
|
|
```
|
|
|
|
查看某次提交详情：
|
|
|
|
```powershell
|
|
git show 提交ID
|
|
```
|
|
|
|
查看当前分支与远程分支差异：
|
|
|
|
```powershell
|
|
git status
|
|
git log --oneline --graph --decorate --all
|
|
```
|
|
|
|
## 13. 推荐学习练习
|
|
|
|
建议新建一个专门练习目录，例如：
|
|
|
|
```powershell
|
|
mkdir git-practice
|
|
cd git-practice
|
|
git init
|
|
```
|
|
|
|
练习 1：第一次提交
|
|
|
|
```powershell
|
|
New-Item readme.md
|
|
Add-Content readme.md "# Git Practice"
|
|
git status
|
|
git add readme.md
|
|
git commit -m "初始化练习文档"
|
|
git log --oneline
|
|
```
|
|
|
|
练习 2：查看差异
|
|
|
|
```powershell
|
|
Add-Content readme.md "第一次修改"
|
|
git diff
|
|
git add readme.md
|
|
git diff --staged
|
|
git commit -m "更新练习文档"
|
|
```
|
|
|
|
练习 3：创建分支
|
|
|
|
```powershell
|
|
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：撤销修改
|
|
|
|
```powershell
|
|
Add-Content readme.md "这是一行想撤销的内容"
|
|
git status
|
|
git restore readme.md
|
|
git status
|
|
```
|
|
|
|
练习 5：查看历史图
|
|
|
|
```powershell
|
|
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. 一句话记忆
|
|
|
|
```text
|
|
status 看状态，diff 看变化，add 进暂存，commit 成版本；
|
|
branch 管分支，switch 换分支，merge 合分支；
|
|
pull 拉远程，push 推远程；
|
|
restore 撤文件，reset 改历史，revert 安全反做，reflog 救现场。
|
|
```
|