Git常用指令

Git 是一个开源的分布式版本控制系统，可以有效、高效地处理从小型到大型项目的版本管理。Git 的优势在于它的分布式架构，它允许用户在本地进行版本控制，同时也可以将更改推送到远程仓库。

以下是常用的 Git 命令列表，按功能分类整理，方便快速查阅：

1. 仓库初始化与克隆

• git init
  初始化当前目录为 Git 仓库。
• git clone <url>
  克隆远程仓库到本地。

2. 提交与修改

• git add <file>
  将文件添加到暂存区（Stage）。

git add .           # 添加所有修改
git add main.cpp    # 添加特定文件

• git commit -m "message"
  提交暂存区的修改到本地仓库。
• git status
  查看工作区和暂存区的状态。
• git diff
  查看未暂存的修改内容。

3. 分支管理

• git branch
  查看本地分支列表。
  git branch -a # 查看所有分支（包括远程）
• git checkout <branch>
  切换分支或恢复文件。

git checkout dev             # 切换到 dev 分支
git checkout -b new-feature  # 创建并切换到新分支
git checkout HEAD~1          # 切换到上一个提交

• git merge <branch>
  合并指定分支到当前分支。
• git rebase <branch>
  变基操作（线性化提交历史）。

4. 远程操作

• git remote add <name> <url>
  添加远程仓库。

git remote add origin https://github.com/user/repo.git

• git push
  推送本地提交到远程仓库。

git push origin main      # 推送到 main 分支
git push -u origin main   # 设置默认推送目标

• git pull
  拉取远程仓库的最新内容并合并。

git pull origin dev

• git fetch
  仅拉取远程仓库的更新，不自动合并。

5. 撤销与回退

• git reset <commit>
  回退到指定提交（慎用，会覆盖历史）。

git reset HEAD~1          # 回退到上一个提交（保留修改）
git reset --hard HEAD~1   # 强制回退并丢弃修改

• git checkout -- <file>
  丢弃工作区的文件修改。
• git revert <commit>
  生成一个新的提交来撤销指定提交的更改（安全操作）。

6. 日志与历史

• git log
  查看提交历史。

git log --oneline      # 简洁模式
git log -p             # 显示修改内容
git log --graph        # 图形化分支历史

• git blame <file>
  查看文件的逐行修改记录。
• git show <commit>
  查看某个提交的详细信息。

7. 其他实用命令

• git stash
  临时保存未提交的修改。

git stash        # 保存修改
git stash pop    # 恢复最近保存的修改

• git tag
  管理标签（用于版本标记）。

git tag v1.0.0           # 创建标签
git push origin v1.0.0   # 推送标签到远程

• git config
  配置 Git 参数。

git config --global user.name "Your Name"
git config --global user.email "[e-mail]"

• git submodule
  管理子模块（嵌套仓库）。
• git remote -v
  查看远程仓库。

注意事项

• 谨慎使用 git reset --hard：会永久丢弃未提交的修改。
• 避免强制推送（git push -f）：可能覆盖他人提交。
• 多用 git fetch + git merge：替代直接 git pull 以更安全地合并代码。