Git 本地使用入门教程:手把手教你用 Git 管理本地代码

学会Git本地三大核心操作:保存修改、查看历史、撤销错误。新手入门看这一篇就够了

580教程5465 字
Git 本地使用入门教程:手把手教你用 Git 管理本地代码

Git 快速上手:本地使用入门教程

Git 是一个帮你记录文件修改过程的工具。即使不连接网络,你也可以用它保存每次修改、查看以前的内容,还能在改错文件后找回原来的版本。

这篇教程只讲 Git 在电脑上的本地用法。跟着示例练习一遍,就能学会日常最常用的操作。


一、先认识 Git 保存文件的三个位置

使用 Git 时,文件改动会按照下面的顺序保存:

TEXT
工作区 -- git add --> 暂存区 -- git commit --> 本地仓库
  • 工作区:你平时打开和修改文件的地方。
  • 暂存区:先把准备保存的改动放在这里。
  • 本地仓库:正式保存每次修改记录的地方,内容放在项目的 .git 目录中。

最常见的操作只有三步:修改文件、把改动放进暂存区、把改动正式保存到本地仓库。


二、检查 Git 并完成基础配置

打开 PowerShell、终端或命令行工具,检查 Git 是否已经安装:

BASH
git --version

如果屏幕上显示了版本号,说明 Git 已经可以使用。第一次使用时,需要填写一个名字和邮箱。以后每次保存修改时,Git 都会用它们标记是谁做了这次修改。邮箱不一定要用真实邮箱。

BASH
git config --global user.name "你的名字"git config --global user.email "your-email@example.com"

查看当前配置:

BASH
git config --global --list

--global 表示这项设置会用在这台电脑的所有 Git 仓库中。如果只想给当前仓库单独设置名字和邮箱,先进入仓库目录,再去掉 --global:

BASH
git config user.name "当前项目使用的名字"git config user.email "project@example.com"

三、创建第一个本地仓库

先创建一个练习目录并进入该目录:

BASH
mkdir git-practicecd git-practice

让 Git 开始管理这个目录:

BASH
git initgit branch -M main

git init 会创建一个隐藏的 .git 目录。Git 会把修改记录和设置保存在里面。git branch -M main 会把当前分支命名为 main,后面的示例都会使用这个名字。

接下来,用任意文本编辑器在当前目录新建 README.md,写入以下内容并保存:

MARKDOWN
# Git 练习项目 这是我的第一个本地 Git 仓库。

查看仓库状态:

BASH
git status

此时,README.md 会显示为“未跟踪文件”。简单来说,就是 Git 发现了这个新文件,但还没有开始记录它。

将文件加入暂存区:

BASH
git add README.md

再次执行 git status,可以看到该文件已经进入待提交状态。现在创建第一条提交:

BASH
git commit -m "添加项目说明"

“提交”就是把当前准备好的改动正式保存一次,就像给项目拍了一张照片。-m 后面的文字是这次保存的说明,简单写清楚做了什么即可。


四、掌握日常修改流程

日常使用 Git,主要就是重复下面几步:

TEXT
编辑文件 -> 看看改了什么 -> 暂存改动 -> 再检查一次 -> 提交

在 README.md 中增加一些内容后,先查看状态:

BASH
git status

查看文件改了哪些内容。这里的“差异”就是修改前和修改后的不同之处:

BASH
git diff

确认改动正确后,将文件加入暂存区:

BASH
git add README.md

查看已经放进暂存区、准备提交的内容:

BASH
git diff --staged

最后提交:

BASH
git commit -m "补充使用说明"

如果有多个文件,可以一次暂存指定文件:

BASH
git add README.md notes.txt

也可以暂存当前目录下的全部改动:

BASH
git add .

使用 git add . 前最好先执行 git status,避免把临时文件、配置文件或无关改动一起提交。

如果一个文件改了很多地方,但你只想提交其中一部分,可以用下面的命令逐段选择:

BASH
git add -p README.md

养成一个简单习惯:提交前再执行一次 git status 和 git diff --staged,确认没有放错文件或内容。


五、查看提交历史

查看完整提交历史:

BASH
git log

每条记录只显示一行,看起来更清楚:

BASH
git log --oneline

想同时查看分支和标签,可以使用:

BASH
git log --oneline --graph --decorate --all

查看最新一次提交的内容:

BASH
git show HEAD

查看某一次提交的具体内容。<提交编号> 要换成 git log 中每条记录前面的那串字母和数字:

BASH
git show <提交编号>

只查看某个文件的提交历史:

BASH
git log -- README.md

六、忽略不应该提交的文件

有些文件不需要让 Git 保存,例如运行日志、程序生成的文件、下载的依赖,以及写有密码的本地配置。可以在仓库最外层创建一个 .gitignore 文件,并写入不想保存的文件规则:

GITIGNORE
# 依赖目录node_modules/ # 程序生成的文件dist/ # 日志*.log # 可能写有密码的本地配置.env

.gitignore 只能直接忽略还没有被 Git 保存过的文件。如果某个文件以前已经提交过,需要先告诉 Git 不再记录它,然后再提交 .gitignore:

BASH
git rm --cached .envgit add .gitignoregit commit -m "忽略本地配置文件"

git rm --cached 只会让 Git 停止记录这个文件,不会删除电脑上的文件。


七、撤销错误操作

撤销操作比较容易弄错。动手前先执行 git status,看看改动是在工作区、暂存区,还是已经提交了。

1. 丢弃尚未暂存的文件修改

BASH
git restore README.md

注意: 这个命令会把文件恢复成最近一次提交时的样子。还没有保存到 Git 的修改会丢失。

2. 取消暂存,但保留文件修改

BASH
git restore --staged README.md

执行后,改动会从暂存区拿出来,但文件内容还在,不会丢失。

3. 修改最近一次提交

如果刚提交完就发现少放了一个文件,可以先暂存这个文件,再把它补进刚才的提交:

BASH
git add missed-file.txtgit commit --amend --no-edit

如果还要修改提交说明:

BASH
git commit --amend -m "新的提交说明"

4. 取消最近一次提交,但保留修改内容

取消提交,改动仍然放在暂存区:

BASH
git reset --soft HEAD~1

取消提交,改动回到工作区:

BASH
git reset HEAD~1

5. 用一条新记录撤销以前的提交

如果不想删除以前的记录,可以新建一条提交,把某次提交做过的修改还原:

BASH
git revert <提交编号>

原来的提交还会保留,Git 只会再加一条撤销记录。

6. 强制回退并丢弃改动

BASH
git reset --hard <提交编号>

高风险操作: --hard 会直接丢掉工作区、暂存区中的改动,也会删除指定提交之后的记录。只有确定这些内容全都不要了,才能使用。


八、使用分支单独完成一项工作

可以把分支理解成一条单独的工作线。你可以在新分支中修改文件,不会马上影响 main 分支中的内容。

查看分支:

BASH
git branch

创建并切换到新分支:

BASH
git switch -c feature/update-readme

在新分支中修改文件并提交:

BASH
git add README.mdgit commit -m "调整项目说明结构"

切回主分支:

BASH
git switch main

把新分支中的修改放进当前的 main 分支:

BASH
git merge feature/update-readme

确认合并完成后,删除已经不需要的功能分支:

BASH
git branch -d feature/update-readme

处理合并冲突

如果两个分支改了同一个文件的同一处,Git 不知道该保留哪一份,就会提示“冲突”。打开冲突文件,通常会看到下面这些标记:

TEXT
<<<<<<< HEAD当前分支的内容=======待合并分支的内容>>>>>>> feature/update-readme

手动留下你需要的内容,并删掉 <<<<<<<、======= 和 >>>>>>> 这些标记。保存文件后执行:

BASH
git add <冲突文件>git commit

如果不想继续合并,可以在提交前取消这次操作:

BASH
git merge --abort

九、临时保存未完成的工作

文件改到一半,暂时还不想提交时,可以用 stash 把改动临时收起来:

BASH
git stash push -m "临时保存正在编写的内容"

查看临时保存列表:

BASH
git stash list

取回最近一次临时保存的改动:

BASH
git stash pop

新建但还没有执行过 git add 的文件,默认不会被 stash 保存。如果也想临时保存这些新文件,需要加上 -u:

BASH
git stash push -u -m "临时保存全部改动"

十、为重要版本添加标签

标签就像给某次提交贴上一个容易记住的名字。例如,完成第一个正式版本时,可以添加 v1.0.0 标签:

BASH
git tag -a v1.0.0 -m "first stable version"

查看所有标签:

BASH
git tag

查看某个标签对应的提交:

BASH
git show v1.0.0

删除本地标签:

BASH
git tag -d v1.0.0

十一、一套完整的本地练习流程

下面是一套完整练习。新建一个练习目录,按照顺序操作,并留意每一步显示了什么。

BASH
# 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

登录后参与评论

登录

暂无评论