Git 新手入门：常用命令速查表¶

Git 是一款强大的版本控制系统，能帮你追踪文件变化、协作开发、回滚代码。对于初学者，掌握核心命令是上手的关键。这份速查表整理了最常用的 Git 命令，附带简单解释和示例，方便随时查阅。

一、基础配置与仓库初始化¶

1. 配置用户信息（全局/局部）¶

• git config --global user.name "你的名字"
  设置全局用户名（对所有仓库生效），后续提交会关联此信息。
  示例：git config --global user.name "张三"

• git config --global user.email "你的邮箱"
  设置全局邮箱（必填，否则提交会报错）。
  示例：git config --global user.email "zhangsan@example.com"

• git config user.name "局部仓库名"
  仅对当前仓库生效，覆盖全局设置（可选，新手建议先用全局）。

2. 初始化本地仓库¶

• git init
  在当前目录创建一个空的 Git 仓库（或初始化已有目录为仓库）。
  示例：在桌面新建文件夹，打开终端执行 git init

二、工作区与暂存区操作¶

1. 查看文件状态¶

• git status
  查看工作区、暂存区的文件变化（哪些文件新增、修改、未跟踪）。
  示例：执行后会显示 "changes to be committed" 等状态提示

2. 将文件添加到暂存区¶

• git add [文件名]
  将指定文件从「工作区」添加到「暂存区」（准备提交）。
  示例：git add test.txt（仅添加 test.txt）

• git add .
  将当前目录所有修改/新增文件添加到暂存区（. 表示当前目录）。
  示例：git add .（添加所有未跟踪文件）

3. 提交暂存区到版本库¶

• git commit -m "提交信息"
  将暂存区的更改永久保存到本地版本库，-m 后需写清晰的提交描述（必填！）。
  示例：git commit -m "添加了 README 说明文档"

三、分支操作¶

1. 创建与切换分支¶

• git branch [分支名]
  创建一个新分支（仅创建，不切换）。
  示例：git branch dev（创建名为 dev 的开发分支）

• git checkout -b [分支名]
  创建并切换到新分支（最常用的分支操作命令）。
  示例：git checkout -b feature/login（创建并切换到登录功能分支）

2. 合并分支¶

• git merge [目标分支]
  将指定分支的更改合并到当前分支（需先切换到目标分支）。
  示例：git checkout master（先切回主分支）→ git merge dev（合并 dev 分支到 master）

3. 查看分支列表¶

• git branch
  查看本地所有分支，当前分支前有 * 标记。
  示例：执行后会显示 master*、dev 等分支

• git branch -r
  查看远程仓库的分支（如 origin/master）。

四、远程仓库操作¶

1. 关联远程仓库¶

• git remote add origin [远程仓库地址]
  将本地仓库关联到远程仓库（首次连接时用），origin 是默认远程仓库名。
  示例：git remote add origin https://github.com/yourname/yourrepo.git

• git remote -v
  查看远程仓库地址（确认关联是否成功）。

2. 拉取与推送代码¶

• git pull origin [分支名]
  从远程仓库拉取代码并合并到本地分支（相当于「拉取+更新」）。
  示例：git pull origin master（拉取远程 master 分支到本地）

• git push origin [分支名]
  将本地分支的更改推送到远程仓库（首次推送需加 -u 建立跟踪关系）。
  示例：git push -u origin dev（首次推送 dev 分支到远程）

五、撤销与恢复操作¶

1. 撤销暂存区文件¶

• git reset HEAD [文件名]
  将暂存区的文件回退到「工作区」（取消 git add）。
  示例：git reset HEAD test.txt（取消暂存 test.txt）

2. 撤销最近一次提交¶

• git reset --soft HEAD~1
  保留工作区和暂存区，仅撤销最近一次提交（回到暂存区）。
  示例：git reset --soft HEAD~1（撤销上一次 commit）

• git reset --hard HEAD~1
  彻底回滚（工作区、暂存区、版本库全回退），慎用！会丢失数据。

3. 放弃工作区修改¶

• git checkout -- [文件名]
  丢弃工作区中指定文件的修改（恢复到最近一次提交状态）。
  示例：git checkout -- app.js（放弃 app.js 的本地修改）

六、查看提交历史¶

• git log
  查看所有提交记录，包括提交 ID、作者、时间、描述。
  常用参数：git log --oneline（简化输出，一行显示）、git log --graph（图形化分支历史）

七、解决常见问题¶

1. 分支合并冲突¶

• 场景：合并分支时，Git 提示「Automatic merge failed」。
• 解决：打开冲突文件（标记 <<<<<<< HEAD 到 ======= 是本地代码，======= 到 >>>>>>> 分支名 是合并代码），手动修改后保存，执行 git add [文件名] → git commit。

2. 暂存未完成工作¶

• git stash
  暂存当前工作区的修改（如突然要切换分支），执行 git stash pop 恢复暂存内容。

总结¶

Git 命令需在实践中熟悉，建议多动手操作。遇到问题时，先用 git --help [命令] 查看帮助，或搜索错误提示。记住：git add → git commit 是基础，分支和远程操作是协作核心。

（收藏本文，遇到问题随时翻查！）