下面是一个「常用命令速查表」，作为git使用的备忘录

首次使用

设置用户名


git config --global user.name "jameskerry651"

设置邮箱


git config --global user.email "[email protected]"

查看当前配置


git config --list

一、仓库初始化 / 克隆

初始化本地仓库


git init

在当前文件夹创建一个新的 Git 仓库（生成 .git 目录）。

克隆远程仓库


git clone <repo-url>

例如： git clone https://github.com/user/project.git

从远程拉一份完整的仓库到本地。

二、查看状态 / 变更

查看当前状态


git status

查看哪些文件被修改、哪些已暂存、当前所在分支等。

查看具体改动


git diff              # 查看工作区相对暂存区的改动
git diff --staged     # 查看暂存区相对最近一次提交的改动

三、添加与提交

添加到暂存区（stage）


git add <file>        # 添加指定文件
git add .             # 添加当前目录下所有改动

提交记录


git commit -m "描述本次修改"

写清楚提交说明，有助于以后回看历史。

四、查看提交历史

查看提交日志


git log
git log --oneline     # 一行一个提交，简洁模式
git log --graph --oneline --all  # 图形化查看分支

五、分支操作

查看/创建/切换分支


git branch            # 列出本地分支
git branch <name>     # 创建分支

git checkout <name>   # 切换分支（老用法）
git switch <name>     # 切换分支（推荐，较新）

git switch -c <name>  # 创建并切换到新分支

合并分支

假设当前在 main 分支，要合并 feature 分支：


git merge feature

如果有冲突，需要手动解决后再：


git add <conflict-files>
git commit

删除分支



git branch -d <name>   # 删除本地分支（已合并）
git branch -D <name>   # 强制删除本地分支

六、远程仓库相关

查看/添加远程仓库



git remote -v               # 查看远程仓库列表
git remote add origin <url> # 添加名为 origin 的远程

抓取 & 拉取代码


git fetch             # 只拉取远程更新，不合并
git pull              # 等于 fetch + merge（把远程分支合并到当前分支）

指定远程和分支：


git pull origin main

推送代码到远程


git push               # 已设置 upstream 时可直接用
git push origin main   # 将本地 main 推到远程 origin/main

首次推送新分支：


git push -u origin <branch>

-u 会设置默认上游分支，后面就可以直接 git push。

七、临时保存、回退

临时保存修改（stash）


git stash             # 把当前未提交的修改暂存起来
git stash list        # 查看所有 stash
git stash pop         # 取出最近一次 stash 并应用
git stash drop        # 删除最近一次 stash

回退修改

撤销工作区的改动（回到暂存区或最近提交）：


git restore <file>          # 恢复文件（新命令）
git checkout -- <file>      # 老命令，作用类似

撤销已经暂存的改动：


git restore --staged <file>

移动当前 HEAD 到某个提交（谨慎）：


git reset --soft <commit>   # 回退到某提交，但保留改动在暂存区
git reset --mixed <commit>  # 默认，改动回到工作区
git reset --hard <commit>   # 全都丢弃到该提交状态（慎用！）

八、Tag（标签）

打标签（常用于版本号）



git tag v1.0.0                  # 在当前提交打轻量标签
git tag -a v1.0.0 -m "说明"     # 带注释标签
git push origin v1.0.0          # 推送指定标签
git push origin --tags          # 推送所有标签

九、远程强制覆盖本地

下载远程仓库最新内容，不做合并


git fetch --all

将本地指针重置为远程分支的最新状态

注意：将 <branch_name> 替换为你的分支名，如 master 或 main


git reset --hard origin/main

(可选) 再次拉取确认同步 git pull