Git 本地使用入门教程:手把手教你用 Git 管理本地代码
学会Git本地三大核心操作:保存修改、查看历史、撤销错误。新手入门看这一篇就够了

Git 快速上手:本地使用入门教程
Git 是一个帮你记录文件修改过程的工具。即使不连接网络,你也可以用它保存每次修改、查看以前的内容,还能在改错文件后找回原来的版本。
这篇教程只讲 Git 在电脑上的本地用法。跟着示例练习一遍,就能学会日常最常用的操作。
一、先认识 Git 保存文件的三个位置
使用 Git 时,文件改动会按照下面的顺序保存:
工作区 -- git add --> 暂存区 -- git commit --> 本地仓库- 工作区:你平时打开和修改文件的地方。
- 暂存区:先把准备保存的改动放在这里。
- 本地仓库:正式保存每次修改记录的地方,内容放在项目的
.git目录中。
最常见的操作只有三步:修改文件、把改动放进暂存区、把改动正式保存到本地仓库。
二、检查 Git 并完成基础配置
打开 PowerShell、终端或命令行工具,检查 Git 是否已经安装:
git --version如果屏幕上显示了版本号,说明 Git 已经可以使用。第一次使用时,需要填写一个名字和邮箱。以后每次保存修改时,Git 都会用它们标记是谁做了这次修改。邮箱不一定要用真实邮箱。
git config --global user.name "你的名字"git config --global user.email "your-email@example.com"查看当前配置:
git config --global --list--global 表示这项设置会用在这台电脑的所有 Git 仓库中。如果只想给当前仓库单独设置名字和邮箱,先进入仓库目录,再去掉 --global:
git config user.name "当前项目使用的名字"git config user.email "project@example.com"三、创建第一个本地仓库
先创建一个练习目录并进入该目录:
mkdir git-practicecd git-practice让 Git 开始管理这个目录:
git initgit branch -M maingit init 会创建一个隐藏的 .git 目录。Git 会把修改记录和设置保存在里面。git branch -M main 会把当前分支命名为 main,后面的示例都会使用这个名字。
接下来,用任意文本编辑器在当前目录新建 README.md,写入以下内容并保存:
# Git 练习项目
这是我的第一个本地 Git 仓库。查看仓库状态:
git status此时,README.md 会显示为“未跟踪文件”。简单来说,就是 Git 发现了这个新文件,但还没有开始记录它。
将文件加入暂存区:
git add README.md再次执行 git status,可以看到该文件已经进入待提交状态。现在创建第一条提交:
git commit -m "添加项目说明"“提交”就是把当前准备好的改动正式保存一次,就像给项目拍了一张照片。-m 后面的文字是这次保存的说明,简单写清楚做了什么即可。
四、掌握日常修改流程
日常使用 Git,主要就是重复下面几步:
编辑文件 -> 看看改了什么 -> 暂存改动 -> 再检查一次 -> 提交在 README.md 中增加一些内容后,先查看状态:
git status查看文件改了哪些内容。这里的“差异”就是修改前和修改后的不同之处:
git diff确认改动正确后,将文件加入暂存区:
git add README.md查看已经放进暂存区、准备提交的内容:
git diff --staged最后提交:
git commit -m "补充使用说明"如果有多个文件,可以一次暂存指定文件:
git add README.md notes.txt也可以暂存当前目录下的全部改动:
git add .使用 git add . 前最好先执行 git status,避免把临时文件、配置文件或无关改动一起提交。
如果一个文件改了很多地方,但你只想提交其中一部分,可以用下面的命令逐段选择:
git add -p README.md养成一个简单习惯:提交前再执行一次 git status 和 git diff --staged,确认没有放错文件或内容。
五、查看提交历史
查看完整提交历史:
git log每条记录只显示一行,看起来更清楚:
git log --oneline想同时查看分支和标签,可以使用:
git log --oneline --graph --decorate --all查看最新一次提交的内容:
git show HEAD查看某一次提交的具体内容。<提交编号> 要换成 git log 中每条记录前面的那串字母和数字:
git show <提交编号>只查看某个文件的提交历史:
git log -- README.md六、忽略不应该提交的文件
有些文件不需要让 Git 保存,例如运行日志、程序生成的文件、下载的依赖,以及写有密码的本地配置。可以在仓库最外层创建一个 .gitignore 文件,并写入不想保存的文件规则:
# 依赖目录node_modules/
# 程序生成的文件dist/
# 日志*.log
# 可能写有密码的本地配置.env.gitignore 只能直接忽略还没有被 Git 保存过的文件。如果某个文件以前已经提交过,需要先告诉 Git 不再记录它,然后再提交 .gitignore:
git rm --cached .envgit add .gitignoregit commit -m "忽略本地配置文件"git rm --cached 只会让 Git 停止记录这个文件,不会删除电脑上的文件。
七、撤销错误操作
撤销操作比较容易弄错。动手前先执行 git status,看看改动是在工作区、暂存区,还是已经提交了。
1. 丢弃尚未暂存的文件修改
git restore README.md注意: 这个命令会把文件恢复成最近一次提交时的样子。还没有保存到 Git 的修改会丢失。
2. 取消暂存,但保留文件修改
git restore --staged README.md执行后,改动会从暂存区拿出来,但文件内容还在,不会丢失。
3. 修改最近一次提交
如果刚提交完就发现少放了一个文件,可以先暂存这个文件,再把它补进刚才的提交:
git add missed-file.txtgit commit --amend --no-edit如果还要修改提交说明:
git commit --amend -m "新的提交说明"4. 取消最近一次提交,但保留修改内容
取消提交,改动仍然放在暂存区:
git reset --soft HEAD~1取消提交,改动回到工作区:
git reset HEAD~15. 用一条新记录撤销以前的提交
如果不想删除以前的记录,可以新建一条提交,把某次提交做过的修改还原:
git revert <提交编号>原来的提交还会保留,Git 只会再加一条撤销记录。
6. 强制回退并丢弃改动
git reset --hard <提交编号>高风险操作:
--hard会直接丢掉工作区、暂存区中的改动,也会删除指定提交之后的记录。只有确定这些内容全都不要了,才能使用。
八、使用分支单独完成一项工作
可以把分支理解成一条单独的工作线。你可以在新分支中修改文件,不会马上影响 main 分支中的内容。
查看分支:
git branch创建并切换到新分支:
git switch -c feature/update-readme在新分支中修改文件并提交:
git add README.mdgit commit -m "调整项目说明结构"切回主分支:
git switch main把新分支中的修改放进当前的 main 分支:
git merge feature/update-readme确认合并完成后,删除已经不需要的功能分支:
git branch -d feature/update-readme处理合并冲突
如果两个分支改了同一个文件的同一处,Git 不知道该保留哪一份,就会提示“冲突”。打开冲突文件,通常会看到下面这些标记:
<<<<<<< HEAD当前分支的内容=======待合并分支的内容>>>>>>> feature/update-readme手动留下你需要的内容,并删掉 <<<<<<<、======= 和 >>>>>>> 这些标记。保存文件后执行:
git add <冲突文件>git commit如果不想继续合并,可以在提交前取消这次操作:
git merge --abort九、临时保存未完成的工作
文件改到一半,暂时还不想提交时,可以用 stash 把改动临时收起来:
git stash push -m "临时保存正在编写的内容"查看临时保存列表:
git stash list取回最近一次临时保存的改动:
git stash pop新建但还没有执行过 git add 的文件,默认不会被 stash 保存。如果也想临时保存这些新文件,需要加上 -u:
git stash push -u -m "临时保存全部改动"十、为重要版本添加标签
标签就像给某次提交贴上一个容易记住的名字。例如,完成第一个正式版本时,可以添加 v1.0.0 标签:
git tag -a v1.0.0 -m "first stable version"查看所有标签:
git tag查看某个标签对应的提交:
git show v1.0.0删除本地标签:
git tag -d v1.0.0十一、一套完整的本地练习流程
下面是一套完整练习。新建一个练习目录,按照顺序操作,并留意每一步显示了什么。
# 1. 初始化仓库mkdir git-practicecd git-practicegit initgit branch -M main
# 2. 使用编辑器创建 README.md,然后暂存并提交git statusgit add README.mdgit diff --stagedgit commit -m "添加最初的项目说明"
练习时不要只复制命令,也要看一看每次 git status 显示的内容。先弄清楚文件现在在哪里,再决定下一步,不需要死记所有命令。
十二、常用命令速查表
| 命令 | 作用 |
|---|---|
git init | 初始化仓库 |
git status | 查看当前状态 |
git diff | 查看未暂存差异 |
git diff --staged | 查看已暂存差异 |
git add <文件> | 暂存指定文件 |
git add . | 暂存当前目录全部改动 |
git commit -m "说明" | 创建提交 |
git log --oneline | 精简查看历史 |
git show <提交编号> | 查看某次提交 |
git restore --staged <文件> | 取消暂存 |
git restore <文件> | 丢弃未暂存修改 |
git switch -c <分支名> | 创建并切换分支 |
git switch <分支名> | 切换分支 |
git merge <分支名> | 合并分支 |
git stash push -m "说明" | 临时保存改动 |
git stash pop | 恢复临时改动 |
git tag -a <标签> -m "说明" | 添加标签 |
总结
学习 Git 不需要一次记住所有命令。先学会 status、add、commit、diff 和 log,就可以保存和查看文件的修改记录。用熟以后,再学习撤销、分支、合并和临时保存。
不知道下一步该做什么时,先运行 git status 看看当前状态。每完成一小部分工作就提交一次,并写清楚提交说明,以后查找和恢复内容会更方便。
评论
0登录后参与评论
登录暂无评论