从零学 Git 版本控制：一个普通人的学习笔记与踩坑实录

最早让我下定决心学 Git 版本控制 的，是一次改稿事故：本地文件被我来回覆盖，半小时的修改找不回来了。后来才知道，只要用 Git 把每次改动记下来，任何一步都能随时退回。这篇 Git 入门教程 是我边学边记的笔记，把新手最容易踩的坑和真正天天用得上的命令都整理出来，希望帮你少走弯路。

一、Git 到底是什么，为什么普通人也要学

简单说，Git 是一个分布式版本控制工具：它给项目的每个文件拍“快照”，并把这些快照按时间串成一条历史线。你每提交一次，Git 就记下“谁、在什么时候、改了什么”。它的好处不只在于“后悔药”，更在于让多人协作不再互相覆盖文件。

对普通人来说，哪怕你只是写文档、做笔记、搭个人站点，Git 也能帮你告别“最终版 / 最终版2 / 真最终版”的混乱。比如我在普通人也能上手：我从零搭建个人网站的学习笔记与踩坑实录里就用 Git 管理整个站点代码，每次改动都能追溯，重装服务器也不慌。

二、10 分钟装好环境并第一次提交

在 Windows 或 Linux 上安装 Git 都只需一条命令或下载安装包。装好后先告诉 Git 你是谁，否则第一次提交会报错：

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

接着进入项目目录，初始化并提交第一份代码：

git init
git add .
git commit -m "init: 第一次提交"

add . 是把改动放进“暂存区”，commit 才真正写入历史。理解“工作区—暂存区—版本库”这三层，是学 Git 最关键的一步。

三、Git 提交规范：别再写“fix”和“update”

新手最容易忽视的就是 Git 提交规范。一条好的提交信息应该让人一眼看懂“改了什么、为什么改”。推荐用“类型: 简述”的格式：

• feat: 新增功能
• fix: 修复问题
• docs: 改文档
• refactor: 重构但不改功能

例如 fix: 修正首页在手机端图片溢出 就比 改了点东西 有价值得多。当提交积累到几十条，规范的信息能让你用 git log --oneline 一眼回顾全程。

四、Git 分支管理：并行开发不打架

真正让 Git 强大的，是Git 分支管理。分支就像一条独立的开发线，你在上面随便改，不会影响主线。常见做法是：main 放稳定版，新功能开一个 feature/xxx 分支去做，做完再合并回去。

git branch feature/login   # 新建分支
git checkout feature/login # 切换过去
git merge feature/login    # 回到 main 后合并

踩过的坑：合并前一定要先 git pull 拉取最新代码，否则很容易出现冲突。遇到冲突别慌，Git 会在文件里标出 <<<<<<< 和 >>>>>>>，手动选留哪段再提交即可。

五、把代码推到远程，换个电脑也能接着干

本地仓库只是起点，把代码推到远程（如 GitHub、Gitee）才能实现备份和协作：

git remote add origin 仓库地址
git push -u origin main

之后每次提交后 git push 即可。换电脑时一条 git clone 仓库地址 就能把整套历史拉下来。我那台把旧笔记本改装成家庭 NAS：全过程记录与踩过的坑的机器，就是用 Git 同步管理各种脚本的，重装系统后几分钟就恢复了全部配置。

六、我踩过的 3 个坑，希望你别再踩

1. 把密码写进仓库

千万别把密钥、配置文件里的密码提交进去。正确做法是用 .gitignore 忽略敏感文件，或用环境变量。

2. 大文件直接塞进 Git

Git 不适合管几百兆的视频和压缩包，会让仓库越来越臃肿。大文件请用对象存储或专门的大文件方案。

3. 长期不提交，一次堆一堆

提交越频繁、粒度越细，回退越精准。建议“一个小改动 = 一次提交”，别等攒一周再一次性提交。

七、写在最后

学 Git 不需要背下所有命令，先掌握 init / add / commit / push / pull / branch / merge 这七个，就能应付 80% 的场景。剩下的等真的遇到再查。如果你想搭自己的内容平台，也可以参考WordPress 插件怎么选？新手必备的 5 类插件与避坑指南，把文章用 Git 管起来的同时，发布流程也能更顺。

版本控制不是程序员的专利，它是每个人管理数字资产的底层习惯。今天就开始，给自己的项目建第一个仓库吧。