nbdime：Jupyter Notebook 的 diff 和 merge 工具

nbdime：Jupyter Notebook 的 diff 和 merge 工具

nbdime 是 Jupyter 团队出品的一个轻量工具，专门处理 Notebook 文件的版本对比和合并冲突。目前在 GitHub 上有 2,831 个 Star。

1、这工具解决了什么问题

用 Jupyter Notebook 写数据分析或实验代码的人，基本都被版本管理折磨过。Notebook 的本质是 JSON 文件，里面混着代码、输出、元数据。直接用 git diff 看改动，满屏都是二进制乱码和无关的格式变动，根本没法正常审阅。

nbdime 就是针对这个痛点做的。它把 Notebook 的 diff 和 merge 过程做了专门优化，让你看到真正有意义的变化：哪些单元格的代码改了、哪些输出变了、哪些元数据调整了，都一目了然。

2、核心功能

nbdime 提供五条命令，覆盖不同场景：

• nbdiff：在终端里并排对比两个 Notebook 的差异
• nbdiff-web：启动一个网页界面，用渲染后的样式展示改动，比终端更直观
• nbmerge：三向合并 Notebook，自动处理没有冲突的部分
• nbmerge-web：网页版的三向合并工具，有冲突时让你手动选择保留哪一边
• nbshow：在终端里格式化展示单个 Notebook 的内容

网页 diff 的效果是亮点。它会把单元格改动按类型标出来：代码修改、输出变化、单元格增删，都用不同的视觉样式区分，比看原始 JSON 舒服太多。

3、安装和使用

直接用 pip 安装：

pip install nbdime

安装后可以配置 git 集成，让 git diff 和 git merge 自动调用 nbdime 处理 .ipynb 文件：

nbdime config-git --enable --global

配置完成后，团队里所有人用 git 管理 Notebook 的体验都会变正常。diff 能看，merge 能合，不再需要手动导出 .py 文件来做版本控制。

4、适合谁用

• 团队协作中使用 Jupyter Notebook 的数据科学家和研究员
• 用 git 管理 Notebook 但受够 diff 乱码的开发者
• 教学场景下需要审阅学生提交的作业或实验报告

这个项目没有复杂的功能堆砌，只做一件事：让 Notebook 的版本管理变得可用。如果你日常用 Jupyter Notebook 并且用 git，装上 nbdime 会省不少时间。