Git 用户手册，命令详细介绍

### Git 用户手册，命令详细介绍 #### 一、版本库与分支 **1. 如何获取一个版本库** 在开始使用 Git 进行项目管理之前，首先需要了解如何创建或克隆一个版本库。通常有两种方式可以获取一个 Git 版本库： - **初始化本地仓库**：如果是一个全新的项目，可以通过 `git init` 命令在一个空目录下初始化一个本地仓库。例如： ```bash mkdir my_project cd my_project git init ``` 这将创建一个名为 `.git` 的隐藏目录，它包含了所有 Git 需要的数据和配置文件。 - **克隆现有仓库**：如果项目已经有了一个远程仓库，可以使用 `git clone` 命令来克隆这个仓库到本地。例如： ```bash git clone https://github.com/username/my_project.git ``` **2. 如何提取项目的不同版本** 提取项目的不同版本通常指的是从历史提交中恢复或检出特定的版本。这可以通过以下几种方式实现： - **检出特定提交**：使用 `git checkout` 命令加上特定的提交哈希值可以检出该提交的状态。例如： ```bash git checkout <commit-hash> ``` 注意这会将当前分支转移到指定的提交，并且会使你处于一个没有名称的分支上。 - **检出特定分支**：如果想要恢复到某个分支的状态，可以直接使用分支名作为参数。例如： ```bash git checkout my_branch ``` **3. 理解历史：交付，父交付与可及性** 每个提交都有一个唯一的哈希值，称为“交付”。每个交付记录了一次对项目文件树的修改，并且包含一个指向前一个提交的指针。如果一个提交有两个或多个父提交，则表示这是一个合并提交。 - **父交付**：每个提交都有一个或多个父提交，它们是直接导致当前提交的先前提交。 - **可及性**：一个提交是另一个提交的“后代”，如果存在一条从后者的提交到前者的提交的路径。换句话说，如果一个提交可以通过一系列的父提交追溯到另一个提交，则前者是后者的一个可及的提交。 **4. 操作分支** 分支是 Git 中的核心概念之一，它允许你在不同的开发线程上独立地工作。操作分支包括创建、切换、合并和删除等动作。 - **创建分支**：使用 `git branch` 命令创建一个新的分支。例如： ```bash git branch new_feature ``` 若要立即切换到新创建的分支，可以使用 `-b` 选项： ```bash git branch -b new_feature ``` - **切换分支**：使用 `git checkout` 命令切换到不同的分支。例如： ```bash git checkout main ``` - **合并分支**：使用 `git merge` 命令可以将一个分支的工作合并到当前分支。例如： ```bash git merge feature_branch ``` - **删除分支**：使用 `git branch -d` 命令删除不再需要的分支。例如： ```bash git branch -d feature_branch ``` **5. 不通过创建新分支来调查旧版本** 有时可能需要查看或恢复旧版本的代码，但又不想创建一个新分支。可以使用 `git checkout` 加上具体的提交哈希值来查看旧版本的文件。例如： ```bash git checkout <commit-hash> -- file_path ``` 这种方式不会改变当前所在分支的位置，只会临时查看该提交中的文件状态。 **6. 调查远程版本库上的分支** 通过 `git fetch` 命令可以从远程仓库获取最新的分支和提交信息，但不会自动合并这些变化。之后可以使用 `git checkout` 来检出这些远程分支。例如： ```bash git fetch origin git checkout origin/main ``` **7. 命名分支，标签，与其他引用** 为了更好地组织和管理项目中的各种版本和标记，合理的命名策略非常重要。 - **命名规则**：通常建议使用简短、描述性强的名字，并遵循一定的约定。例如，使用 `feature/` 开头的分支名来标识特性分支。 - **标签**：用于标记重要的版本点。例如，使用 `v1.0.0` 来标记第一个稳定版本。 **8. 用 git fetch 更新版本库** `git fetch` 是从远程仓库拉取数据而不自动合并的一种方式。这有助于避免意外合并冲突。 - **拉取远程分支**：使用 `git fetch` 命令从远程仓库拉取数据。例如： ```bash git fetch origin ``` - **查看远程分支**：使用 `git branch -r` 可以列出所有远程跟踪分支。例如： ```bash git branch -r ``` **9. 获取其他版本库的分支** 除了从默认的远程仓库（通常是 `origin`）获取分支外，还可以从其他远程仓库获取分支。 - **添加远程仓库**：使用 `git remote add` 添加新的远程仓库。例如： ```bash git remote add upstream https://github.com/example/repo.git ``` - **拉取特定远程仓库的分支**：使用 `git fetch` 指定远程仓库名。例如： ```bash git fetch upstream ``` #### 二、检索 Git 历史 **1. 如何用平分来定位撤退** 定位引入了问题的提交是一项常见的任务。Git 提供了 `git bisect` 命令来自动化这一过程。 - **启动平分模式**：使用 `git bisect start` 进入平分模式。例如： ```bash git bisect start ``` - **指定好坏边界**：需要先指出最近已知无问题的提交（好的边界）和已知有问题的提交（坏的边界）。例如： ```bash git bisect good v1.0.0 git bisect bad v1.2.0 ``` - **自动测试**：运行自动化测试脚本，根据结果确定下一步操作。例如： ```bash git bisect run ./test.sh ``` - **手动测试**：根据测试结果，标记当前提交是好还是坏。例如： ```bash git bisect good git bisect bad ``` **2. 创建标签** 标签用于标记重要的提交点，如发布版本。 - **创建标签**：使用 `git tag` 命令创建标签。例如： ```bash git tag v1.0.0 ``` - **列出标签**：使用 `git tag` 列出所有标签。例如： ```bash git tag ``` - **推送标签到远程仓库**：使用 `git push` 命令推送标签到远程仓库。例如： ```bash git push origin v1.0.0 ``` **3. 浏览修订** 使用 `git log` 命令可以查看项目的修订历史。例如： ```bash git log ``` **4. 生成差异** 差异是两个版本之间的变化。使用 `git diff` 命令可以比较不同提交之间或不同文件之间的差异。例如： ```bash git diff HEAD~1 ``` **5. 查看旧的文件版本** 查看旧版本的文件可以帮助你了解项目的演变过程。使用 `git show` 命令可以查看任何历史版本的文件内容。例如： ```bash git show <commit-hash>:file_path ``` **6. 实例** - **统计一个分支中的交付数目**：使用 `git rev-list` 命令可以统计分支中的提交数量。例如： ```bash git rev-list --count main ``` - **检查两分支是否在同一历史时期**：通过比较两个分支的最近共同祖先提交来判断。例如： ```bash git merge-base main feature ``` - **找到包含给定修正的第一个标签版本**：可以结合使用 `git log` 和 `grep` 命令来查找。例如： ```bash git log --grep="fix: some issue" --pretty=format:'%h' --tags --simplify-by-decoration ``` - **显示仅属于某个分支的交付**：可以使用 `git log` 并限制历史范围。例如： ```bash git log --not --merges --pretty=format:'%h %s' feature..main ``` - **为软件的发行制作变更日志和压缩包**：结合使用 `git log` 和 `git archive` 命令可以生成变更日志和压缩包。例如： ```bash git log v1.0.0..v1.1.0 > CHANGELOG git archive --format=tar --output=v1.1.0.tar v1.1.0 ``` - **寻找一个指向包含给定内容的文件的交付**：使用 `git log` 结合 `grep` 命令来搜索特定内容。例如： ```bash git log --name-only --pretty=format: -- <file_path> | grep "some content" ``` #### 三、用 Git 进行研发 **1. 告诉 Git 你的名字** 为了确保每次提交都有正确的作者信息，需要设置用户的姓名和电子邮件地址。例如： ```bash git config --global user.name "Your Name" git config --global user.email "[email protected]" ``` **2. 创建新的版本库** 已经在前面的部分详细介绍了创建新的版本库的过程。 **3. 如何制作一个交付** 制作交付是 Git 工作流程中最基本的操作之一。 - **添加文件到暂存区**：使用 `git add` 命令将文件添加到暂存区。例如： ```bash git add README.md ``` - **提交更改**：使用 `git commit` 命令提交更改。例如： ```bash git commit -m "Add README" ``` **4. 写好交付信息** 编写清晰、简洁的提交信息对于团队协作至关重要。 - **信息格式**：推荐使用祈使句形式，并保持主题行不超过 50 个字符。 - **详情描述**：如果需要提供更详细的信息，可以在主题行下方使用多行文本。 **5. 忽略文件** 忽略某些文件或目录可以帮助减少仓库的大小并避免不必要的提交。可以通过创建 `.gitignore` 文件来指定需要忽略的文件模式。例如： ```bash # .gitignore node_modules/ *.log ``` **6. 如何合并** 合并是将一个分支的工作整合到另一个分支中。 - **简单的合并**：如果两个分支之间没有冲突，可以直接使用 `git merge` 命令合并。例如： ```bash git merge feature_branch ``` - **解决合并冲突**：如果合并时出现了冲突，需要手动解决这些冲突。 **7. 解决合并冲突** 当合并时遇到冲突，可以使用以下步骤来解决： - **编辑冲突文件**：打开包含冲突标记的文件，并解决其中的冲突。 - **添加解决后的文件**：使用 `git add` 将解决后的文件添加到暂存区。 - **完成合并**：再次运行 `git commit` 命令完成合并操作。 **8. 撤销合并** 如果合并造成了问题，可以撤销合并。 - **硬回滚**：使用 `git revert` 或 `git reset` 命令撤销合并。例如： ```bash git revert <merge-commit-hash> ``` **9. 快进合并** 当合并分支时，如果目标分支的所有提交都在源分支的基线上，则可以使用快进合并来简化合并过程。 - **启用快进合并**：默认情况下，`git merge` 命令支持快进合并。 **10. 修复失误** - **通过新的交付修复**：对于较小的错误，可以通过创建新的提交来修复。 ```bash git commit --amend -m "Fix typo in README" ``` - **通过重写历史修复**：对于较大的错误，可能需要重写提交历史来彻底修复问题。例如： ```bash git rebase -i <commit-hash> ``` **11. 提取一个文件的旧版本** 如果需要恢复文件的旧版本，可以使用 `git checkout` 命令。例如： ```bash git checkout <commit-hash> -- file_path ``` **12. 临时放下手头上的工作** 当你需要暂时离开正在处理的工作，而又不想丢失未提交的更改时，可以使用 `git stash` 命令。例如： ```bash git stash save "WIP on main" ``` **13. 确保好的性能** 为了确保 Git 在大型项目中的高效运行，可以采取以下措施： - **使用浅克隆**：对于大仓库，可以使用 `--depth=1` 参数进行浅克隆，只获取最新一次提交的历史记录。 - **优化对象存储**：定期运行 `git gc` 命令来清理垃圾对象并优化仓库。 **14. 确保伸缩性** 为了确保项目的稳定性和可靠性，需要定期检查仓库的健康状况。 - **检查仓库损坏**：使用 `git fsck` 命令检查仓库是否存在损坏。例如： ```bash git fsck ``` 以上是 Git 用户手册中关于版本库与分支、检索 Git 历史以及用 Git 进行研发的详细介绍。通过掌握这些核心功能，开发者可以更有效地管理和协作于 Git 项目。