很多开发者接触 Git 的第一印象是「GitHub 远程仓库」，但常常忽略了 Git 最核心的本质：它是一套分布式版本控制系统，哪怕不联网、没有任何远程仓库，仅凭本地环境就能完整管理代码的每一次变更——记录修改、回溯版本、追溯历史，全在本地完成。
尤其对于Vibe Coding流行的今天，为了能找回被大模型改乱的代码，掌握本地Git的操作更为重要。
今天我们就从一个最简单的 Python HelloWorld 项目入手，从零走一遍完整的本地版本管理流程，看完就能直接上手。
理解 Git 命令的前提，是先理清本地代码的三层流转逻辑：
.git 隐藏文件夹。每一次提交都会在这里生成一个永久的版本快照，可以随时回溯。我们日常执行的绝大多数 Git 命令，本质都是在这三个区域之间移动文件、同步状态。
先把最核心的本地操作命令做个汇总，后面实战会逐一用到：
| 命令 | 作用 | 常用场景 |
|---|---|---|
git init |
在当前目录初始化一个 Git 仓库 | 新项目第一次启用版本管理 |
git status |
查看工作区、暂存区的文件状态 | 随时确认当前改动情况 |
git add 文件名 |
将指定文件从工作区加入暂存区 | 准备提交单个/多个文件 |
git add . |
将当前目录所有改动加入暂存区 | 批量提交全部改动 |
git commit -m "提交说明" |
将暂存区内容提交到版本库，生成一个版本 | 完成一次版本记录 |
git log |
查看完整提交历史 | 追溯版本记录、查找版本号 |
git log --oneline |
简洁单行展示提交历史 | 快速浏览版本链 |
git diff |
查看工作区文件的具体改动内容 | 提交前确认修改细节 |
git reset --hard 版本号 |
回退到指定版本 | 撤销改动、回溯历史版本 |
注：首次使用 Git 需要先配置全局用户名和邮箱，用于标记提交人，仅需执行一次：
git config --global user.name "你的姓名" git config --global user.email "你的邮箱"
下面我们通过一个真实的 Python 项目，从零走一遍「初始化→写代码→提交→迭代→查历史→回退」的完整流程。
首先创建项目文件夹，并在文件夹内初始化 Git 环境。
打开终端，依次执行：
# 创建项目文件夹
mkdir python-helloworld
# 进入项目目录
cd python-helloworld
# 初始化 Git 仓库
git init
执行成功后会提示 Initialized empty Git repository，此时文件夹内会生成一个隐藏的 .git 目录——这就是本地版本库的本体，不要手动修改它。
此时执行 git status 查看状态，会提示「当前没有可提交的文件」，说明仓库是空的，准备就绪。
我们来写第一个版本的 HelloWorld 程序。
在项目目录下新建 hello.py 文件，写入最简单的输出代码：
print("Hello, World!")
保存文件后，回到终端执行 git status，可以看到 hello.py 显示为红色「未跟踪文件」（Untracked files），说明这个文件还没有被 Git 纳入版本管理。
接下来把文件加入暂存区，再提交到版本库：
# 将 hello.py 加入暂存区
git add hello.py
# 再次查看状态，文件变绿，说明已进入暂存区
git status
# 提交到版本库，生成第一个版本
git commit -m "feat: 实现基础 HelloWorld 输出功能"
-m 参数后面跟的是提交说明，建议养成规范书写的习惯，一般采用「类型: 描述」的格式：
feat：新增功能fix：修复 bugdocs：文档变更refactor：代码重构提交成功后，终端会显示本次提交的哈希值、改动文件数、代码行数，第一个版本就正式生成了。
接下来我们升级一下程序，增加自定义姓名问候的功能。
修改 hello.py 内容：
name = input("请输入你的名字：")
print(f"Hello, {name}! 欢迎学习 Git 版本管理")
保存后，我们可以先看看具体改了什么：
# 查看工作区文件的改动详情
git diff
终端会清晰标出新增、删除的代码行，确认改动无误后，执行批量提交：
# 将当前目录所有改动加入暂存区
git add .
# 提交第二个版本
git commit -m "feat: 增加自定义姓名问候交互"
现在我们已经有两个版本了，可以查看完整的版本记录：
# 查看完整提交历史（哈希、作者、时间、说明）
git log
# 简洁单行展示，快速浏览
git log --oneline
git log --oneline 会输出类似下面的结果，每行对应一个版本，最前面的字符串就是版本哈希值（版本唯一标识）：
a1b2c3d feat: 增加自定义姓名问候交互
e4f5g6h feat: 实现基础 HelloWorld 输出功能
如果发现新版本有问题，想回到最初的简单版本怎么办？用 git reset 命令即可一键回溯。
# 方式1：回退到上一个版本（HEAD 代表当前版本，^ 代表上一个）
git reset --hard HEAD^
# 方式2：通过版本哈希精确回退（推荐，更稳妥）
git reset --hard e4f5g6h
执行完成后，再打开 hello.py，会发现代码已经回到了第一个版本的内容。
注意：
--hard参数会强制覆盖工作区的代码，执行前请确认不需要保留未提交的改动。
如果回退后又后悔了，想回到最新版本怎么办？直接用 git log 已经看不到后面的版本了，这时可以用 git reflog 查看所有操作记录，找到新版本的哈希值再回退回去：
# 查看所有历史操作记录
git reflog
# 找到对应版本的哈希，执行回退即可恢复
git reset --hard a1b2c3d
实际项目中，并不是所有文件都需要纳入版本管理。比如 Python 运行生成的 __pycache__ 目录、.pyc 编译文件、本地虚拟环境 venv 等，这些都是运行产物，提交到版本库里毫无意义。
我们可以在项目根目录创建 .gitignore 文件，写入需要忽略的文件规则：
# 忽略 Python 编译产物
__pycache__/
*.pyc
*.pyo
# 忽略虚拟环境
venv/
# 忽略 IDE 配置文件
.vscode/
.idea/
保存后执行提交：
git add .gitignore
git commit -m "docs: 添加 .gitignore 忽略规则"
从此以后，Git 会自动忽略匹配规则的文件，不会再出现在状态提示里。
小步提交，粒度清晰
不要攒一大堆改动再一次性提交，尽量一个功能点、一次修复对应一次提交。粒度越小，后续回溯、定位问题越方便。
提交信息规范可读
清晰的提交说明是版本历史的灵魂，避免写「更新代码」「修复问题」这种无效描述，让自己半年后看历史也能一眼看懂每次提交做了什么。
提交前先检查改动
执行 git commit 前，先用 git diff 过一遍改动，避免不小心提交了调试代码、临时注释、敏感信息。
重要项目务必远程备份
本地版本管理虽然方便，但硬盘损坏、设备丢失会导致所有版本记录丢失。重要项目建议推送到 GitHub、Gitee 等远程仓库做备份，本地+远程双重保障。
本地 Git 操作是整个版本控制体系的基础，分支管理、远程协作、多人合并等进阶功能，本质都是在本地操作的基础上延伸而来。不用一开始就追求复杂命令，先把「提交-查看-回退」的基础流程练熟，从小项目开始养成版本管理的习惯，慢慢就能体会到 Git 带来的安全感——再也不用靠「文件改名备份」来管理代码了。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。