git命令手册

### Git命令手册详解 #### 一、概述 Git是一款分布式版本控制系统，被广泛应用于软件开发过程中，用于管理项目源码的版本控制。本手册旨在帮助用户掌握Git的基本使用方法，涵盖了从创建仓库到推送更新的一系列操作。 #### 二、创建仓库 ##### 2.1 克隆远程仓库 **命令**: `git clone ssh://[email protected]/xx.git` **功能**: 将远程仓库克隆到本地。 **说明**: 通过SSH协议连接远程服务器，并将远程仓库的内容复制到本地指定路径下。 ##### 2.2 初始化本地仓库 **命令**: `git init` **功能**: 在本地创建一个新的Git仓库。 **说明**: 如果需要在一个全新的目录中开始使用Git管理版本，可以使用此命令进行初始化。 #### 三、本地变更管理 ##### 3.1 查看当前版本状态 **命令**: `git status` **功能**: 显示工作区的状态信息。 **说明**: 该命令可以帮助开发者了解哪些文件被修改过，哪些文件被添加或删除等信息。 ##### 3.2 显示未添加至索引的变更 **命令**: `git diff` **功能**: 显示所有未添加到暂存区的更改。 **说明**: 通常用于查看尚未被纳入下一次提交的更改内容。 ##### 3.3 比较与上一个版本的差异 **命令**: `git diff HEAD^ HEAD -- ./lib` **功能**: 比较当前版本与前一版本之间的差异。 **说明**: 此命令主要用于查看文件的具体改动情况，`HEAD^`表示当前分支的上一个提交记录。 ##### 3.4 增加更改过的文件至索引 **命令**: `git add .add*` **功能**: 将修改过的文件添加到暂存区。 **说明**: 通过将文件添加到暂存区，可以在之后进行提交操作时选择性地提交部分更改。 ##### 3.5 提交更改 **命令**: `git commit -m 'xxx'` **功能**: 提交暂存区的所有更改到仓库。 **说明**: `-m`后面跟随的是提交信息，用来描述此次提交的主要内容。 ##### 3.6 合并上一次提交 **命令**: `git commit --amend -m 'xxx'` **功能**: 修改最后一次提交的信息或内容。 **说明**: 当发现上一次提交的信息有误或需要补充时，可以使用此命令进行修改。 ##### 3.7 合并添加和提交步骤 **命令**: `git commit -a -m 'xxx'` **功能**: 直接提交所有已经跟踪的文件更改。 **说明**: 该命令会自动将所有已跟踪文件的更改添加到暂存区，并执行提交操作。 #### 四、提交历史管理 ##### 4.1 显示日志 **命令**: `git log` **功能**: 显示所有的提交记录。 **说明**: 通过查看提交日志，可以了解到项目的变更历史和每次提交的详情。 ##### 4.2 显示某个提交的详细内容 **命令**: `git show <commit>` **功能**: 显示指定提交的详细信息。 **说明**: `<commit>`指的是具体的提交ID，可以通过该命令查看单个提交的详细信息。 ##### 4.3 显示每个文件的提交信息 **命令**: `git blame <file>` **功能**: 显示文件每行的最后修改者及其提交信息。 **说明**: 对于追踪文件的历史变更非常有用，可以帮助开发者了解文件的演变过程。 #### 五、分支与合并 ##### 5.1 合并分支到当前分支 **命令**: `git merge <branch>` **功能**: 将指定分支合并到当前分支。 **说明**: 适用于两个分支都存在的场景，例如开发分支和主分支之间的合并。 ##### 5.2 重新应用分支到当前分支 **命令**: `git rebase <branch>` **功能**: 将指定分支的更改重新应用到当前分支。 **说明**: 适用于当前分支只有一个分支的情况，常用于调整提交顺序或清理历史记录。 ##### 5.3 取消正在进行的rebase操作 **命令**: `git rebase --abort` **功能**: 终止正在进行的rebase操作。 **说明**: 当发现rebase过程中出现错误或不想继续时，可以使用此命令来取消。 ##### 5.4 解决rebase冲突后继续执行 **命令**: `git rebase --continue` **功能**: 在解决完rebase中的冲突后继续执行。 **说明**: 当rebase过程中遇到冲突，手动解决冲突后使用此命令继续完成rebase操作。 ##### 5.5 使用工具解决冲突 **命令**: `git mergetool` **功能**: 使用图形化工具解决冲突。 **说明**: 通过可视化界面来辅助解决冲突问题，使解决冲突变得更加直观。 #### 六、撤销操作 ##### 6.1 重置至最新版本 **命令**: `git reset --hard HEAD` **功能**: 将工作区回滚到最近一次提交的状态。 **说明**: 通常用于撤销最近的一次提交或解决merge失败的情况。 ##### 6.2 重置至某个提交状态 **命令**: `git reset --hard <commit>` **功能**: 将工作区回滚到指定提交的状态。 **说明**: 需要谨慎使用，因为它会丢失未提交的更改。 ##### 6.3 重置文件到某个状态，保留本地未提交的文件 **命令**: `git reset <commit>` **功能**: 移除暂存区中的文件更改，但保留工作区中的未提交更改。 **说明**: 当只想移除暂存区中的更改而不影响工作区时使用。 ##### 6.4 重置至某个状态，保留版本库中不同的文件 **命令**: `git reset --merge <commit>` **功能**: 移除暂存区中的文件更改，并保留工作区中的更改。 **说明**: 适合于希望保留某些文件的更改，但又想清除其他文件更改的情况。 ##### 6.5 重置至某个状态，保留更改过的文件 **命令**: `git reset --keep <commit>` **功能**: 清空暂存区，但保留工作区中的更改。 **说明**: 主要用于保留文件更改的同时清空暂存区。 ##### 6.6 丢弃本地更改信息 **命令**: `git checkout HEAD <file>` **功能**: 丢弃本地文件的更改，恢复到最近一次提交的状态。 **说明**: 如果只需要恢复一个文件到最近一次提交的状态，可以使用此命令。 ##### 6.7 撤销提交 **命令**: `git revert <commit>` **功能**: 创建一个新的提交来撤销指定提交的效果。 **说明**: 通过创建新的提交来逆向操作，避免直接修改历史记录。 #### 七、分支与标签管理 ##### 7.1 显示本地分支 **命令**: `git branch` **功能**: 列出当前项目中所有本地分支。 **说明**: 有助于了解当前项目中有哪些分支正在使用。 ##### 7.2 切换分支 **命令**: `git checkout <branch>` **功能**: 切换到指定的分支。 **说明**: 切换分支是Git中常见的操作之一，用于快速切换到不同的开发环境。 ##### 7.3 新建分支 **命令**: `git branch <new-branch>` **功能**: 创建一个新的本地分支。 **说明**: 通常用于隔离开发，创建新特性或修复bug。 ##### 7.4 创建新分支跟踪远程分支 **命令**: `git branch --track <new> <remote>` **功能**: 创建一个本地分支，并让它跟踪指定的远程分支。 **说明**: 这样可以确保本地分支能够同步远程分支的变化。 ##### 7.5 删除本地分支 **命令**: `git branch -d <branch>` **功能**: 删除指定的本地分支。 **说明**: 删除不再需要的分支可以节省空间，并保持项目结构清晰。 ##### 7.6 给当前分支打标签 **命令**: `git tag <tag-name>` **功能**: 给当前分支的某个提交添加标签。 **说明**: 标签可以用于标记重要的版本发布点，方便后续查找。 #### 八、远程仓库交互 ##### 8.1 列出远程仓库信息 **命令**: `git remote -v` **功能**: 显示所有远程仓库及其URL。 **说明**: 用于查看当前项目关联了哪些远程仓库。 ##### 8.2 显示某个远程仓库信息 **命令**: `git remote show <remote>` **功能**: 显示指定远程仓库的详细信息。 **说明**: 包括远程仓库的URL、本地分支与远程分支的映射关系等。 ##### 8.3 添加远程仓库 **命令**: `git remote add <remote> <url>` **功能**: 将远程仓库添加到项目中。 **说明**: 通过指定远程仓库的URL来添加远程仓库，便于后续的拉取或推送操作。 ##### 8.4 获取远程分支信息 **命令**: `git fetch <remote>` **功能**: 从远程仓库拉取数据，但不合并到本地分支。 **说明**: 可以看到远程仓库最新的提交信息，但需要手动执行合并操作。 ##### 8.5 更新本地分支 **命令**: `git pull <remote> <branch>` **功能**: 从远程仓库拉取数据并合并到当前分支。 **说明**: 既可以获取远程仓库的数据，也可以将这些数据合并到本地分支中。 ##### 8.6 推送本地更新到远程仓库 **命令**: `git push <remote> <branch>` **功能**: 将本地分支的更改推送到远程仓库。 **说明**: 确保远程仓库中的数据是最新的。 ##### 8.7 删除远程分支 **命令**: `git push <remote> --delete <branch>` **功能**: 从远程仓库删除指定的分支。 **说明**: 当远程分支不再需要时，可以使用此命令删除它。 ##### 8.8 推送本地标签 **命令**: `git push --tags` **功能**: 将本地的所有标签推送到远程仓库。 **说明**: 确保远程仓库也包含了本地的所有标签信息。 通过以上介绍，我们可以看到Git提供了非常丰富的功能来帮助开发者高效地进行版本管理和协同工作。熟练掌握这些基本命令，将大大提升团队的工作效率。