AI Engineering Tools

编程

Git/GitHub 工作术语

了解仓库、branch、commit、同步、PR、冲突与安全操作的搜索型参考资料。

33 个项目

核心概念

仓库

Repository

engineerdoge/math-ai-tools

含义

一个由 Git 跟踪的项目文件夹,通常镜像在 GitHub 上。

用途

当您要求检查项目、提交工作或比较分支时,存储库是正在处理的单元。

示例

engineerdoge/math-ai-tools

请求示例

检查当前的仓库状态。

核心概念

工作树

Working tree

git status

含义

当前在您的机器上签出的文件,包括尚未提交的编辑。

用途

使用它来区分已提交的历史记录和当前正在进行的编辑。

示例

git status

请求示例

显示工作树中更改的内容。

核心概念

暂存区域

Staging area

git add src/components/SiteHeader.tsx

含义

将包含在下一次提交中的更改的临时选择。

用途

它可以让您仅提交属于同一组的文件或代码块。

注意

暂存本身不保存历史记录。提交操作才是记录历史的操作。

示例

git add src/components/SiteHeader.tsx

请求示例

仅暂存用于 Git 术语页面的文件。

核心概念

提交

Commit

git commit -m "Add Git terms reference"

含义

仓库历史中已选定更改的保存快照。

用途

提交允许稍后审查、比较、部署或回滚更改。

示例

git commit -m "Add Git terms reference"

请求示例

创建一个带有简洁信息的提交。

核心概念

差异

Diff

git diff

含义

对两个文件状态之间更改的逐行视图。

用途

差异(Diff)是查看编辑的具体内容,然后再提交的快速方法。

示例

git diff

请求示例

审查意外更改的差异。

分支

分支

Branch

qwen3.5

含义

一条可以独立于其他工作线的命名工作线。

用途

分支允许您在不立即更改主分支的情况下开发功能。

示例

qwen3.5

请求示例

请告诉我,我当前位于哪个分支。

分支

main 分支

main branch

main

含义

通常表示稳定或可生产版本的默认分支。

用途

将您的工作分支与主分支进行比较,以查看发生了哪些更改。

示例

main

请求示例

将此分支与主分支进行比较。

分支

checkout

checkout

git switch qwen3.5

含义

将工作树更改为另一个分支或提交。

用途

当您需要检查或继续处理另一个分支时使用。

注意

未提交的更改可能会阻止切换分支,因为它们将被覆盖。

示例

git switch qwen3.5

请求示例

在检查未提交的更改后,切换到 qwen3.5 分支。

分支

合并

merge

git merge main

含义

将一个分支的更改合并到另一个分支中。

用途

使用 merge 将主分支上的更新合并到你的特性分支,或者将特性分支合并到主分支。

注意

合并可能会在两个分支都以不同的方式编辑同一行时创建冲突。

示例

git merge main

请求示例

解释在将 main 合并到此分支之前会发生什么。

分支

rebase

rebase

git rebase main

含义

将一个分支的提交应用到另一个分支的基提交上。

用途

在合并功能分支之前,它可能会使历史记录看起来是线性的。

注意

`rebase` 会重写提交历史,因此在使用时应谨慎,尤其是在共享分支上。

示例

git rebase main

请求示例

不要立即进行代码合并。首先解释此分支的风险。

同步

clone

clone

git clone https://github.com/user/project.git

含义

复制远程仓库的本地副本。

用途

它通常是开始在现有 GitHub 项目上工作的第一步。

示例

git clone https://github.com/user/project.git

请求示例

克隆此仓库并显示可用的分支。

同步

远程。

remote

origin git@github.com:user/project.git

含义

一个从本地存储库到托管在其他位置的存储库的命名连接。

用途

远程设置决定拉取和推送的通信方式。

示例

origin git@github.com:user/project.git

请求示例

显示配置的远程仓库。

同步

fetch

fetch

git fetch origin

含义

在不修改您的工作文件的情况下,下载远程分支信息。

用途

在比较您的分支与最新的远程状态之前,请使用 `fetch` 命令。

示例

git fetch origin

请求示例

从源拉取,然后将此分支与主分支进行比较。

同步

pull

pull

git pull origin main

含义

获取远程更改并将其应用于当前分支。

用途

使用它来更新您的本地分支,以包含已推送到其他地方的工作。

注意

提取可能会更改您的工作分支,并可能导致冲突。

示例

git pull origin main

请求示例

在拉取之前,请检查我是否有未提交的本地更改。

同步

push

push

git push origin qwen3.5

含义

将本地提交上传到远程仓库。

用途

`push` 命令将您的本地提交推送到 GitHub 或其他远程仓库。

注意

`push` 命令仅上传提交,而不上传未提交的工作树更改。

示例

git push origin qwen3.5

请求示例

在确认构建成功后,推送当前分支。

同步

origin

origin

git push origin qwen3.5

含义

从远程克隆的存储库的默认名称。

用途

大多数推送、拉取和获取示例使用 origin 作为远程名称。

示例

git push origin qwen3.5

请求示例

检查 origin 是否指向预期的 GitHub 仓库。

审查

提取请求

Pull Request

从 qwen3.5 创建一个 PR 并合并到 main 分支。

含义

GitHub 上的一个页面,用于讨论和合并分支更改。

用途

使用拉取请求 (PR) 来审查已更改的文件、运行检查、讨论评论并安全地合并。

示例

从 qwen3.5 创建一个 PR 并合并到 main 分支。

请求示例

总结应该包含在 PR 描述中的内容。

审查

审查

Review

审查请求的更改

含义

检查代码更改是否存在错误、回归、可读性问题以及缺失的测试。

用途

审查有助于在将分支合并到共享代码库之前发现问题。

示例

审查请求的更改

请求示例

审查此分支是否存在错误和缺失的测试。

冲突

合并冲突

Merge conflict

CONFLICT (content): src/app/page.tsx 文件中的合并冲突

含义

Git 无法自动合并来自不同分支的更改的情况。

用途

在合并继续之前,您必须选择正确的最终内容。

注意

不要盲目接受任何一方的说法。首先检查预期的行为。

示例

CONFLICT (content): src/app/page.tsx 文件中的合并冲突

请求示例

解释冲突,并提出最安全的解决方案。

冲突

冲突标记

Conflict marker

<<<<<<< HEAD

含义

文本标记,Git 将其插入到文件中以显示冲突的版本。

用途

标记显示哪些部分来自您当前的分支,哪些部分来自传入的分支。

注意

冲突标记不应保留在已提交的代码中。

示例

<<<<<<< HEAD

请求示例

查找任何剩余的冲突标记。

冲突

未跟踪的文件

Untracked file

?? src/lib/git-github.ts

含义

一个存在于文件夹中的文件,但尚未添加到 Git 跟踪中。

用途

新的页面和组件通常显示为未跟踪状态,直到进行暂存。

示例

?? src/lib/git-github.ts

请求示例

列出未跟踪的文件,并告诉我哪些文件属于此功能。

冲突

修改后的文件

Modified file

M src/components/SiteHeader.tsx

含义

一个被跟踪的文件,其内容与上次提交的版本不同。

用途

它可以帮助您查看哪些现有文件受到了当前工作的影响。

示例

M src/components/SiteHeader.tsx

请求示例

显示此任务的修改文件。

安全操作

暂存区

stash

git stash push -m "before branch switch"

含义

暂时保存未提交的更改,以便工作目录可以恢复到干净状态。

用途

在切换分支之前,请使用 stash,如果你还没有准备好提交。

注意

暂存的工作可能会被遗忘。始终清晰地命名它,并有意识地重新应用它。

示例

git stash push -m "before branch switch"

请求示例

在切换分支之前,使用清晰的消息暂存我当前的修改。

安全操作

重置。

reset

git reset --soft HEAD~1

含义

将分支或暂存状态恢复到另一个提交或状态。

用途

软重置或混合重置可以调整本地提交,然后再将其共享。

注意

强制重置可能会丢弃工作。使用前请先询问原因。

示例

git reset --soft HEAD~1

请求示例

解释最安全地撤销上次本地提交而不丢失更改的方法。

安全操作

撤销。

revert

git revert abc1234

含义

创建一个新的提交,该提交撤销了之前的提交。

用途

回滚通常比在推送提交后重写历史记录更安全。

示例

git revert abc1234

请求示例

回滚有问题的提交,而无需重写共享的历史记录。

安全操作

强制推送

force push

git push --force-with-lease origin qwen3.5

含义

使用本地分支历史覆盖远程分支。

用途

有时,它会在私有功能分支上重写本地历史记录后使用。

注意

强制推送可能会擦除其他人的远程提交。 最好使用 force-with-lease 并先确认。

示例

git push --force-with-lease origin qwen3.5

请求示例

不要强制推送。解释是否需要使用带有租用的强制推送。

安全操作

.gitignore

.gitignore

.next/

含义

一个文件,用于告诉 Git 哪些文件或文件夹不应被跟踪。

用途

用于构建输出、依赖项、本地环境文件和临时文件。

示例

.next/

请求示例

检查构建输出是否被正确忽略。

命令

git status

git status

git status --short

含义

一个命令,显示分支、暂存的更改、已修改的文件和未跟踪的文件。

用途

在编辑、提交、拉取或切换分支之前运行它。

示例

git status --short

请求示例

运行 `git status` 并仅总结重要的更改。

命令

git log

git log

git log --oneline -5

含义

一个用于查看提交历史的命令。

用途

用于查找最近的提交、比较工作,或识别要回滚的提交。

示例

git log --oneline -5

请求示例

以紧凑格式显示最近的五个提交。

命令

git add

git add

git add src/lib/git-github.ts

含义

一个命令,用于将更改暂存以进行下一次提交。

用途

当您想要进行有针对性的提交时,请使用明确的路径。

示例

git add src/lib/git-github.ts

请求示例

仅暂存为本页面创建的文件。

命令

git commit

git commit

git commit -m "Add Git terms reference"

含义

一个命令,用于将暂存的更改记录到存储库历史中。

用途

使用一条消息,说明发生了什么变化以及为什么它很重要。

示例

git commit -m "Add Git terms reference"

请求示例

使用清晰的消息提交已暂存的更改。

命令

git pull

git pull

git pull --ff-only

含义

一个命令,用于从远程分支更新当前分支。

用途

`--ff-only` 选项可以避免创建意外的合并提交。

示例

git pull --ff-only

请求示例

仅在安全的情况下才使用 `ff-only`。

命令

git push

git push

git push origin HEAD

含义

一个命令,用于将本地提交上传到远程分支。

用途

在测试通过并且提交准备好共享后,使用它。

示例

git push origin HEAD

请求示例

在确认没有 lint 或构建错误后,推送此分支。