Git 仓库的常见命令与使用指南

1. 引言

Git 是目前最流行的分布式版本控制系统，广泛用于代码管理、协作开发和版本追踪。掌握 Git 的常用命令，是每个开发者必备的基础技能。本文将从仓库初始化、日常提交、分支管理、远程协作到撤销与回退，系统梳理 Git 仓库的常见命令及使用场景。

2. 仓库初始化与配置

在使用 Git 之前，需要先初始化仓库，并配置用户信息。用户信息会记录在每次提交中，是协作开发时识别作者身份的重要依据。

# 初始化一个 Git 仓库
git init
配置全局用户名和邮箱
git config –global user.name "Your Name"
git config –global user.email "you@example.com"
查看当前配置
git config –list

3. 日常提交与状态查看

日常开发中，最常用的操作是查看工作区状态、暂存文件并提交。理解工作区、暂存区和版本库三者的关系，是正确使用 Git 的基础。

# 查看工作区状态
git status
查看文件具体改动
git diff
将文件加入暂存区
git add <file>
git add . # 添加所有改动
提交到版本库
git commit -m "提交说明"
查看提交历史
git log –oneline

4. 分支管理

分支是 Git 的核心特性之一，允许开发者在独立的分支上并行开发，互不干扰。合理使用分支可以提升团队协作效率，降低代码冲突风险。

# 查看本地分支
git branch
创建新分支
git branch <branch-name>
切换分支
git checkout <branch-name>
git switch <branch-name> # 新版推荐
创建并切换分支
git checkout -b <branch-name>
合并分支到当前分支
git merge <branch-name>
删除分支
git branch -d <branch-name>

5. 远程仓库协作

远程仓库是团队协作的桥梁。通过远程仓库，开发者可以推送本地提交、拉取他人更新，并处理合并冲突。

# 关联远程仓库
git remote add origin <remote-url>
查看远程仓库
git remote -v
推送本地分支到远程
git push -u origin <branch-name>
拉取远程更新并合并
git pull
拉取远程更新但不自动合并
git fetch
克隆远程仓库
git clone <remote-url>

6. 撤销与回退

开发过程中难免需要撤销错误操作。Git 提供了多种撤销方式，适用于不同场景，使用时需要根据改动是否已提交、是否已推送来选择合适的方法。

# 撤销工作区修改（未暂存）
git checkout — <file>
撤销暂存（保留工作区修改）
git reset HEAD <file>
回退到上一个提交（保留工作区修改）
git reset –soft HEAD~1
回退到上一个提交（丢弃工作区修改）
git reset –hard HEAD~1
撤销某次提交并生成新提交
git revert <commit-id>

7. 常用进阶命令

以下命令在团队协作和代码审查中经常使用，可以帮助开发者更高效地管理提交历史和定位问题。

# 查看某次提交的详细改动
git show <commit-id>
暂存当前工作区改动
git stash
git stash pop # 恢复暂存
查看所有分支的提交图
git log –graph –oneline –all
查看某个文件的提交历史
git log –follow <file>
打标签
git tag v1.0.0
git push origin v1.0.0

8. 总结

Git 的命令体系虽然庞大，但日常开发中高频使用的命令相对有限。掌握仓库初始化、日常提交、分支管理、远程协作和撤销回退这几类核心命令，就能覆盖绝大多数开发场景。建议在实际项目中多加练习，逐步理解 Git 的底层模型，从而更从容地应对复杂的协作需求。