本文将带您熟悉每天都会重复的基本工作流程：获取项目副本、保存更改（commit）、将更改推送到 GitHub（push），并通过 .gitignore 设置忽略不需要的文件。这也是 Claude Code 在为您处理仓库时会执行的流程，所以了解它会让您受益更多。

文中的示例和界面截图基于 JetBrains IDE；操作名称和位置可能因您使用的版本而异。练习时请使用单独的教学仓库。在实际项目中，请遵循项目的分支、提交和推送规则。

克隆项目

您已经在 GitHub 上有一个仓库，现在需要在计算机上获取它的本地副本，才能开始工作。这个过程称为 克隆。

步骤 1。启动 IDE。如果已经打开了项目，请通过 File | Close Project 将其关闭。在启动页面（Welcome Screen）中选择 Clone Repository（或 Get from VCS）。

"克隆项目"章节插图

步骤 2。在打开的窗口中粘贴仓库 URL。如果您要克隆他人的仓库，这种方式很方便：可以直接从 GitHub 仓库页面复制 URL。

输入用于克隆的 URL

如果要克隆自己的仓库，最简单的方式是在 IDE 中通过 Log in to GitHub 登录 GitHub 账户。IDE 会打开浏览器供您授权。

JetBrains IDE 中的 GitHub 授权窗口

在打开的页面上，点击绿色按钮 Authorize JetBrains。之后，您就可以直接在 IDE 的列表中选择自己的仓库。选中所需项目，然后点击 Clone。

可供克隆的仓库列表

步骤 3。确认是否信任项目。对于熟悉的自有仓库，可以选择 Trust Project。对于陌生仓库，请先检查其内容和运行说明：信任项目后，IDE 可以执行项目中的操作。

步骤 4。打开项目。在 Windows 上，IDE 可能会建议将项目加入杀毒软件的排除项，以加快索引速度。学习 Git 并不需要这样做；不要为了克隆项目而关闭安全防护。

配置杀毒软件排除项

保存更改 - commit

commit 是项目在某个时刻保存下来的快照。可以把它想成游戏里的存档点：出了问题，您随时可以回到这里。每个提交都有唯一标识符，以及一条描述更改的消息。

Kotlin
历史中的连续快照ABCD
历史中的连续快照

提交历史：每个新提交都基于前一个提交构建，串起项目的发展过程。

步骤 1。进行更改。打开 README.md 文件并添加项目说明。开始编辑后，IDE 会在项目面板中将文件名标成蓝色，表示文件已更改，但更改尚未保存到 Git。更改行旁边还会出现彩色竖线：绿色表示新增行，蓝色表示已修改的行。

已更改文件的高亮显示

打开 Commit 选项卡，查看已更改的文件。JetBrains 的常规模式使用更改列表（changelists）；单独的 Git staging 模式需要在设置中启用。不要把此窗口中的勾选项与终端里已暂存到 Git 索引的内容混为一谈。

IntelliJ IDEA 中的 Commit 窗口

这里显示的是：

  • Changes - Git 已跟踪且已修改的文件（此处是 README.md）；
  • Unversioned Files - Git 在项目目录中发现、但尚未开始跟踪的新文件。

步骤 2。检查选中的 diff。Unversioned Files 中的新文件尚未被跟踪。通常会通过 .gitignore 排除构建产物、缓存和个人设置。项目的共享设置可能会纳入 Git；在忽略整个 .idea/ 目录之前，请先检查项目规则。

步骤 3。创建提交。输入清晰的提交说明，例如 docs: Describe the project in README，检查所选 diff，然后点击 Commit。如果启用了提交前检查，请等待检查完成。打开 Git Log，确认新提交包含所需文件。

提交成功
与 Claude Code 的联系

Claude Code 提议创建提交时，背后执行的是 git commit，并使用选定的文件和提交说明。养成亲自查看文件列表的习惯在这里也很有用：确认 Claude 要提交的正是您需要的内容，读一遍提交说明，然后决定同意还是修改。

将更改推送到 GitHub - push

您的提交目前只保存在本机。要与团队共享，或将它们保存在可靠的位置，需要把提交推送到 GitHub 上的远程仓库。

  • 本地提交
  • git push
  • 远程分支

Push 会用您的提交更新所选远程分支。它不会下载他人的更改，也不会推送尚未提交的文件。

步骤 1。点击 Push。Push 按钮位于顶部主工具栏（Main Toolbar），图标是指向右上的箭头。

Main Toolbar 上的 Push 按钮

步骤 2。检查并确认。窗口中会列出所有准备推送的提交。这是最后一次确认推送内容是否正确的机会。点击 Push。

Push 确认窗口

推送成功后，IDE 会显示通知。请检查其中的仓库和目标分支：本练习中是 origin/main。通知文本会因 IDE 版本而异。

步骤 3。在 GitHub 上检查结果。在浏览器中打开 GitHub 仓库页面，确认您的更改和文件已经显示在那里。

与 Claude Code 的联系

Claude Code 可以替您推送更改（git push）。请记住：只有已经记录在提交中的内容才会发送到服务器。因此，在提交阶段检查快照中包含哪些内容，也就是在确认哪些内容会出现在 GitHub 上。

Git 控制面板

IDE 中有单独的 Git 工具窗口，顶部工具栏也提供快捷操作。这里就是您的版本控制中心。主要按钮包括：

IDE 中的 Git 控件
  • Commit（勾选标记）- 打开用于保存更改的面板；
  • Push（右上箭头）- 打开将提交推送到 GitHub 的窗口；
  • Branches - 分支管理控件（位于左上角）；
  • Show Git Log - 查看项目的全部提交历史，就像您的私人时光机。

获取更新

Update Project 会获取更改并将其合并到本地分支；IDE 会根据设置使用 merge 或 rebase。更新前请先保存尚未完成的工作，并确认所选的更新方式。

开始新任务前，请检查文件状态以及所需分支是否为最新。如果有其他人的提交，请获取并按照项目规则合并。更新时可能需要解决冲突；这并不意味着今后不会再出现冲突。

忽略不需要的文件 - .gitignore

如果项目中出现了辅助文件或构建产物，而您不希望它们意外进入仓库，就应将它们加入忽略规则。为此，需要在项目根目录创建一个名为 .gitignore 的特殊文件。

通常忽略哪些内容，为什么

几乎每种技术栈都会产生一些不适合放进 Git 的文件，因为它们只与您的计算机有关，或会在构建时重新生成：

  • 构建目录（例如 build/、dist/）- 可以轻松重新生成的编译产物；
  • 包管理器缓存和依赖项（例如 node_modules/）- 可能占用数百 MB，而且与您的系统相关；
  • IDE 的个人设置，例如工作窗口状态。.idea/ 中也可能包含项目共享设置，因此只有在项目规则允许时才应忽略整个目录；
  • 操作系统文件（.DS_Store、Thumbs.db）- 操作系统自动创建的辅助文件。

如何手动忽略文件：

步骤 1。假设您创建了一个本地文件 notes.txt，里面写着草稿。请在项目树中右键点击该文件。

创建临时文件

步骤 2。依次打开菜单 Git -> Add to .gitignore -> Add to .gitignore。此选项会将所选文件添加到项目根目录的 .gitignore 中。

通过菜单添加到 .gitignore

如果还没有 .gitignore 文件，IDE 会提示您创建，请确认即可。

步骤 3。IDE 会自动将文件名添加到 .gitignore 中。

文件已添加到 .gitignore

符合规则的未跟踪文件通常会从待添加列表中消失；IDE 中的颜色取决于主题。这并不能阻止手动强制添加文件，也无法从历史记录中删除已经保存的内容。如果这条规则需要对所有人生效，请将 .gitignore 本身也提交。

请注意

如果文件已经被跟踪。将文件添加到 .gitignore 并不会停止跟踪。命令 git rm --cached 文件路径 会将文件从索引中移除，同时保留工作副本；然后再通过提交记录这项更改。之前的版本仍会留在历史记录中。如果涉及密钥或其他秘密信息，应先撤销访问权限，不能只靠忽略文件来处理。

.gitignore 的规则

该文件中列出 Git 应忽略的文件名和目录名模式。空行会被忽略，注释以 # 开头。

  • * - 可匹配任意数量的字符。例如，*.log 会忽略所有扩展名为 .log 的文件；
  • 模式末尾的 / 表示目录。例如，build/ 会忽略 build 目录中的所有内容；
  • 行首的 ! 会反转规则。例如，已有规则 *.log 时，!important.log 会让该文件不再匹配这条忽略规则；将它添加后，Git 就会开始跟踪它；
  • 斜杠之间的 ** 可匹配任意层级的子目录，也包括没有子目录的情况。例如，logs/**/*.log 可以匹配 logs/a.log，也可以匹配 logs/2026/09/a.log。
C++

.gitignore 文件示例

# 构建和缓存目录
build/
dist/
node_modules/

# IDE 的个人状态（JetBrains）
.idea/workspace.xml

# 操作系统文件
.DS_Store
Thumbs.db

现成模板

不必从头编写这些文件，社区已经准备了经过验证的模板：

  1. GitHub 提供的 .gitignore 模板集合，涵盖多种语言和框架：https://github.com/github/gitignore；
  2. gitignore.io - 一个可根据您的技术栈生成 .gitignore 的 Web 服务（只需输入语言、操作系统和 IDE）。

Claude Code 如何配合 Git 工作

Claude Code 可以替您完成这套日常流程。使用时请留意以下几点：

  • Claude 可以自行创建提交并执行 push - 您需要检查提交包含哪些内容，并阅读提交说明；
  • 规范的 .gitignore 有助于排除不需要的内容，但提交前仍应检查选中的文件；
  • 更新前先检查分支状态和未完成的工作，更新后再检查合并结果。
与 Claude Code 的联系

同意创建提交或执行 push 之前，请查看 Claude Code 显示的 diff。这与在 Commit 窗口中检查勾选项是一样的，只不过发起更改的是 Claude。这样，只有您确实认可的内容才会进入历史记录并推送到服务器。

上一篇文章：Git 和 GitHub 入门 · 下一篇文章：Git 分支与合并