IntelliJ IDEA 里怎么用 Git：从入门到日常协作

适用：IntelliJ IDEA（Community / Ultimate，界面以近年版本为准）
关键词：VCS · Commit · Push · Branch · Merge · Conflict · Git Log
本文面向熟悉一点命令行 Git、想在 IDEA 里「点着完成」日常协作的同学。
配图来源：JetBrains 官方教程Getting started with Git in IntelliJ IDEA（截图版权归 JetBrains 所有，仅作学习引用）。

写在前面

很多同学学 Git 是从命令行开始的：add/commit/push/pull/checkout。
在 IDEA 里，这些操作都有图形入口，并且多了三样命令行不好直观看到的东西：

1. 文件颜色与 Gutter 变更条——一眼看出改了哪一行；
2. Commit 工具窗口——勾选文件、写提交说明、看 Diff；
3. 三方合并界面——冲突时左/中/右对照解决。

建议心智模型：

IDEA 不替代 Git，只是把 Git 操作可视化；底层仍是本机安装的git可执行文件。

官方完整英文教程：Working with Git tutorial。

一、使用前准备

1.1 安装 Git

• Windows：安装 Git for Windows，勾选「将 Git 加入 PATH」。
• macOS：xcode-select --install或 Homebrew 安装 Git。
• IDEA 首次检测到未安装 Git 时，会提示下载。

1.2 在 IDEA 中确认 Git 路径

Settings（macOS 为Preferences）→Version Control→Git→Path to Git executable→ 点Test。

常用快捷键（Windows / Linux）：

二、三种「把项目接上 Git」的方式

2.1 新建项目时勾选 Create Git repository

欢迎页New Project，填写项目名与路径，勾选Create Git repository，点 Create。

创建成功后，底部/状态栏会出现 Git 相关入口（VCS widget、Commit、Git 工具窗口）。

2.2 已有项目开启版本控制

菜单：VCS → Enable Version Control Integration…→ 选择Git→ OK。
等价于在项目根目录执行git init，再由 IDEA 关联。

2.3 Clone 远程仓库

欢迎页Get from VCS，或Git → Clone…，填入 HTTPS/SSH 地址，选本地目录。
适合直接拉 GitHub / Gitee / GitLab 上的项目（例如本仓库Factory_Test_Demo）。

三、认文件颜色：谁改了、谁是新的

开启 Git 后，Project 视图与编辑器 Tab 会用颜色提示：

编辑器左侧Gutter（行号旁竖条）可点开看这一段相对上次提交改了什么：

四、日常主流程：改代码 → Commit → Push

4.1 添加文件到 Git（Add）

新建文件时，IDEA 常会弹出是否加入版本控制：

若错过对话框：在 Project 里右键文件 →Git → Add（或Ctrl + Alt + A）。

加入后会出现在 Commit 工具窗口的变更列表中：

4.2 Commit（提交到本地仓库）

1. 打开Commit工具窗口（Alt + 0/Ctrl + K）。
2. 勾选要提交的文件。
3. 写清楚的提交说明（建议写「为什么」，而不是「改了啥」的流水账）。
4. 点Commit（或Commit and Push）。

提交说明支持文件名补全：

提交成功会有通知；也可在通知里改提交说明：

在 Commit 窗口双击文件可看完整 Diff：

对应命令行：

gitadd<files>gitcommit-m"your message"

4.3 Push（推到远程）

Git → Push或Ctrl + Shift + K。在 Push 对话框里可再确认要推的提交与文件 Diff：

对应命令行：git push

第一次推新分支时，IDEA 会提示设置 upstream（类似git push -u origin feature-xxx）。

4.4 Pull / Update（同步远程）

Git → Update Project…或Ctrl + T。可选 Merge 或 Rebase：

• Merge：拉远程后做合并提交（等价git pull --no-rebase）。
• Rebase：把本地提交接到远程最新之后（等价git pull --rebase）。

团队约定用哪一种即可；个人小项目用 Merge 通常更省心。

五、分支：功能开发的「平行宇宙」

5.1 看当前分支 / 新建分支

点状态栏或右上角VCS widget（显示当前分支名，如main）：

选中基线分支 →New Branch：

勾选Checkout branch可创建后立即切换。切换成功后，widget 会显示新分支名：

有未提交改动时切换分支，IDEA 会要求你先Commit / Shelve / Stash，避免改动丢失。

5.2 推荐习惯

main / master ← 稳定、可演示 feature/xxx ← 新功能 fix/xxx ← 修 bug

本地做完 → Push 远程分支 → 在 GitHub/Gitee 提 PR/MR → 评审后合入主分支。

六、合并与冲突解决（IDEA 最强项之一）

6.1 合并另一分支进当前分支

例如在main上合并new_feature：在分支菜单中选中功能分支 →Merge ‘new_feature’ into ‘main’：

6.2 出现冲突时

若两边改了同一处，会弹出Conflicts对话框：

可选：

点Merge进入合并界面：

• 左：当前分支（如 main）
• 右：进来的分支（如 new_feature）
• 中：结果编辑区，可接受左右改动、也可手改

解决后点Apply。全部冲突处理完再 Commit / Push。

项目视图里改动文件也会用颜色标出：

七、看历史：谁改的、哪次提交

7.1 项目 Git Log

Git工具窗口（Alt + 9）→Log标签：按分支过滤、搜作者/说明、右键 Cherry-Pick / Revert 等。

7.2 单文件历史

编辑器或 Project 中右键文件 →Git → Show History：

选中一段代码 →Git → Show History for Selection，只看这段的演变：

行尾注解（Annotate / Blame）：右键 Gutter →Annotate with Git Blame，看每一行最后是谁、哪次提交改的。

八、分享到 GitHub（可选）

本地已有仓库时：Git → GitHub → Share Project on GitHub。

发布成功后通知里会有仓库链接：

也可在 GitHub 网页新建空仓库，再在 IDEA 里Git → Manage Remotes…添加origin，然后 Push。

九、和本项目相关的实用建议

以Factory_Test_Demo这类 Spring Boot 仓库为例：

1. 不要提交密钥：application-param.yaml、含 API Key 的本地文件应进.gitignore。
2. Commit 粒度：一个功能/一次修复一次提交，方便回滚与 Code Review。
3. 推送前 Update：先Ctrl + T再 Push，减少远程拒绝与冲突。
4. 大文件 / target：target/、.idea中个人配置是否提交，团队要统一（个人项目可提交.idea部分，协作项目通常忽略）。
5. 改完 AI 模块注释、配置后：在 Commit 窗口勾选相关文件 → 写说明 → Push 到你的远程分支。

十、常用操作速查（IDEA ↔ 命令行）

十一、小结

在 IDEA 里用 Git，抓住三条线就够日常开发：

Commit 窗口 → 管「本地改了什么、提交什么」 VCS / 分支条 → 管「在哪条线上开发、合并谁」 Git Log → 管「历史怎么查、出错怎么回退」

配图均来自 JetBrains 官方文档资源站（resources.jetbrains.com）。若界面与截图略有出入，以你安装的 IDEA 版本为准；更细的操作可直接打开：

• Getting started with Git in IntelliJ IDEA
• Commit and push changes
• Set up a Git repository

把「命令行会做的那几步」在 IDEA 里走通一遍之后，冲突合并和历史排查通常会比纯命令行更省心。