git diff 命令（手把手讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 100w+ 字，讲解图 4013+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3700+ 小伙伴加入学习 ，欢迎点击围观

在版本控制系统中，Git 是开发者最常用的工具之一。而 git diff 命令作为 Git 的核心功能之一，能够帮助开发者快速识别代码修改的差异，是日常开发中不可或缺的工具。无论是检查工作目录中的未提交更改，还是比较不同分支、提交之间的差异，git diff 都能提供清晰直观的对比结果。本文将从基础用法到高级技巧，结合实际案例，深入解析这一命令的使用方法和应用场景。

一、Git Diff 命令的基础概念

1.1 什么是 Git Diff？

Git Diff 是一个用于显示代码差异的命令，它的核心功能是通过对比两个代码版本或状态，展示出哪些内容被修改、新增或删除。可以将其想象为一面“镜子”，能够清晰地反映出代码的“变化轨迹”。

1.2 差异对比的常见场景

• 工作目录与暂存区：查看尚未暂存的修改。
• 暂存区与最新提交：确认即将提交的更改。
• 不同提交记录：比较两次提交之间的代码变化。
• 分支对比：分析两个分支的代码差异。

二、Git Diff 命令的基础用法

2.1 基础语法与核心参数

git diff [选项] [路径]

• 无参数时的默认行为：对比工作目录与暂存区的差异。
• 常用参数：
  • --staged：对比暂存区与最新提交。
  • HEAD：对比工作目录与最新提交。
  • <commit>：指定某个提交记录作为对比基准。
  • --cached：与 --staged 等价，但更易理解。

2.2 实战案例：查看未暂存的修改

假设你正在编辑 main.js 文件，修改了代码但尚未暂存：

git diff

输出示例：

diff --git a/main.js b/main.js
index 1a2b3c..4d5e6f 100644
--- a/main.js
+++ b/main.js
@@ -1,3 +1,4 @@
 function greet() {
-  console.log("Hello!");
+  console.log("Hello, World!");
 }

解释：

• a/main.js 表示“修改前的版本”，b/main.js 是“修改后的版本”。
• @@ -1,3 +1,4 @@ 表示从第1行开始，旧版本3行与新版本4行的对比。

2.3 比较暂存区与最新提交

若已暂存部分修改，但尚未提交：

git diff --staged

此命令会显示暂存区与最新提交（即 HEAD）的差异，帮助开发者确认即将提交的内容。

三、Git Diff 的进阶技巧

3.1 比较两个提交记录

假设你有两个提交 commit-A 和 commit-B，想查看它们之间的差异：

git diff commit-A commit-B

示例输出：

diff --git a/config.json b/config.json
index 7f8a2b..c3d4e5 100644
--- a/config.json
+++ b/config.json
@@ -2,7 +2,7 @@
 "port": 3000,
 "debug": true,
 "database": {
-  "host": "localhost"
+  "host": "prod-server.com"
 }

技巧：

• 使用 git log 找到提交哈希值，再结合 git diff 进行对比。
• 可替换 commit-A 和 commit-B 为分支名，例如 git diff feature-branch main。

3.2 比较分支差异

当需要合并分支时，先用 git diff 预览差异：

git diff feature-branch main

此命令会显示 feature-branch 和 main 分支之间的代码差异，帮助开发者提前识别潜在冲突。

3.3 限制对比范围

若只需查看某个文件或目录的差异：

git diff path/to/file.js
git diff -- path/to/directory/

示例：

git diff src/components/Header.jsx

四、Git Diff 的隐藏功能与实用场景

4.1 对比工作目录与任意提交

直接指定提交哈希值对比当前代码：

git diff HEAD~2

此命令会显示当前工作目录与两次提交前的版本之间的差异，适用于快速回溯修改。

4.2 使用 --color-words 突出显示文本差异

当对比文本内容（如配置文件或文档）时，使用此参数能更清晰地看到单词级差异：

git diff --color-words

4.3 结合 git show 查看提交历史差异

虽然 git show 主要用于查看提交详情，但也可通过它对比两次提交：

git show commit-A..commit-B

五、常见问题与解决方案

5.1 误操作导致差异过大时如何处理？

• 使用 git diff --stat 快速查看差异统计，避免被冗长的代码淹没：

  git diff --stat
  

5.2 如何仅查看新增或删除的行？

• 新增行：git diff --numstat | grep '+\|-'
• 删除行：git diff --numstat | grep '-\|+'

5.3 如何将差异输出到文件？

git diff > changes.txt

六、Git Diff 在团队协作中的价值

6.1 预防合并冲突

在合并分支前运行：

git diff origin/main

可提前发现与远程分支的差异，减少冲突风险。

6.2 审查代码修改

在代码评审时，使用：

git diff --cached

快速查看待提交的更改，确保符合规范。

结论：善用 Git Diff 提升开发效率

git diff 命令不仅是代码差异的“显微镜”，更是开发者日常工作中不可或缺的工具。通过掌握其基础语法、进阶技巧及隐藏功能，开发者能够更高效地追踪修改、预防错误，并提升团队协作的透明度。无论是初学者还是中级开发者，理解并熟练使用 git diff，都能显著提升代码管理的精细化程度，让版本控制真正成为开发流程中的“安全网”与“导航仪”。

附录：Git Diff 命令速查表

通过本文的深入解析，希望读者能全面掌握 git diff 命令 的核心用法，并在实际开发中灵活运用，进一步提升代码管理的效率与准确性。