Git 入门教程：从零开始管理代码版本

-

摘要

Git 是最流行的版本控制系统。本教程依据 Git 官方文档整理，从安装配置讲起，覆盖工作区/暂存区/仓库三区概念、add 与 commit 日常循环、关联 GitHub 远程仓库、分支操作，以及 restore/revert 等后悔药命令和 .gitignore 用法。

Git 入门教程：从零开始管理代码版本

Git 是分布式的版本控制系统，写代码、写文档、管配置，凡是"改来改去怕丢"的文本内容都值得用 Git 管理。本教程依据 Git 官方文档（git-scm.com/book）整理。

一、安装与首次配置

bash

sudo apt install git        # Debian/Ubuntu
git --version

git config --global user.name "kunkun"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

用户名和邮箱会写进每次提交记录，先配好再动手。

二、基本工作流

Git 本地有三个"区域"：工作区（改文件的地方）→ 暂存区（git add）→ 仓库（git commit）。

bash

git init                    # 在当前目录初始化仓库
git status                  # 查看文件状态，最常敲的命令
git add README.md           # 把单个文件加入暂存
git add .                   # 把所有改动加入暂存
git commit -m "第一次提交"   # 提交到仓库
git log --oneline           # 查看提交历史（一行一条）

日常循环就是：改代码 → git status 看看 → git add . → git commit -m "说明"。

三、远程仓库：GitHub/Gitee

bash

git remote add origin git@github.com:user/repo.git   # 关联远程仓库
git push -u origin main     # 首次推送
git push                    # 之后的推送
git pull                    # 拉取远程更新
git clone git@github.com:user/repo.git   # 克隆已有仓库

推荐用 SSH 密钥方式认证（参考本站 SSH 密钥登录教程），免密且安全。

四、分支：平行世界

bash

git branch                  # 查看分支
git switch -c dev           # 创建并切换到 dev 分支
git switch main             # 切回主分支
git merge dev               # 把 dev 合并到当前分支
git branch -d dev           # 删除已合并的分支

习惯做法：main 保持可用，功能开发都在独立分支进行，写完合并回来。

五、后悔药

bash

git restore 文件名           # 丢弃工作区未暂存的修改（不可恢复！）
git restore --staged 文件名  # 把文件移出暂存区（保留修改）
git commit --amend          # 修改最近一次提交的说明
git reset --soft HEAD~1     # 撤销最近一次提交，改动保留
git revert 提交号           # 生成一次"反向提交"，安全地撤销历史提交

已推送到远程的历史，用 revert 而不是 reset，避免坑队友。

六、.gitignore：不想管的东西

在仓库根目录建 .gitignore 文件：

纯文本

node_modules/
*.log
.env
.DS_Store

这些文件就不会被 add 和 push。GitHub 官方 gitignore 模板库覆盖了几乎所有语言。

七、总结

需求	命令
保存一次进度	`git add .` + `git commit -m "说明"`
推到远程	`git push`
拉更新	`git pull`
开新功能	`git switch -c 分支名`
撤销未提交改动	`git restore 文件`
撤销最近提交	`git reset --soft HEAD~1`

记住一条心法：commit 要小而勤，说明要写清楚。版本历史就是你的时光机，提交越细，后悔药越有效。

END

Git 入门教程：从零开始管理代码版本

摘要

Git 入门教程：从零开始管理代码版本

一、安装与首次配置

二、基本工作流

三、远程仓库：GitHub/Gitee

四、分支：平行世界

五、后悔药

六、.gitignore：不想管的东西

七、总结

相关文章

tar 打包与压缩教程：xz/gz 一条命令搞定

fnm 使用教程：秒切 Node.js 版本

Linux 文件权限教程：chmod 与 chown 一次搞懂

crontab 定时任务教程：让命令到点自动执行