我做了Albert & Rich所做的——不要给.ipynb文件做版本(因为这些文件可能包含图像，这会变得混乱)。相反，要么总是运行ipython notebook——script，要么放c.FileNotebookManager。在你的配置文件中save_script = True，这样当你保存你的笔记本时，总是会创建一个(可版本的).py文件。

为了重新生成笔记本(在签出一个repo或切换一个分支之后)，我将脚本py_file_to_notebook .py放在我存储笔记本的目录中。

现在，签出一个repo之后，只需运行python py_file_to_notebook .py来生成ipynb文件。切换分支后，您可能需要运行python py_file_to_notebook .py -ov来覆盖现有的ipynb文件。

为了安全起见，也可以加上 *。Ipynb到你的。gitignore文件。

编辑:我不再这样做了，因为(A)每次签出分支时，你都必须从py文件中重新生成你的笔记本，(B)在笔记本中有其他东西，如markdown，你会丢失。相反，我使用git过滤器从笔记本中剥离输出。关于如何做到这一点的讨论在这里。

(2017-02)

策略

on_commit (): 去掉输出>的名称。Ipynb (nbstripout) 去掉输出> name.clean.ipynb (nbstripout，) 总是nbconvert to python: name.ipynb.py (nbconvert) 始终转换为markdown: name.ipynb.md (nbconvert, ipymd) vcs.configure (): Git difftool, mergetool: nbdiff和nbmerge from nbdime

工具

nbstripout: strip the outputs from a notebook src: https://gist.github.com/minrk/6176788 src: https://github.com/kynan/nbstripout pip install nbstripout; nbstripout install ipynb_output_filter: strip the outputs from a notebook src: https://github.com/toobaz/ipynb_output_filter/blob/master/ipynb_output_filter.py ipymd: convert between {Jupyter, Markdown, O'Reilly Atlas Markdown, OpenDocument, .py} src: https://github.com/rossant/ipymd nbdime: "Tools for diffing and merging of Jupyter notebooks." (2015) src: https://github.com/jupyter/nbdime docs: http://nbdime.readthedocs.io/ nbdiff: compare notebooks in a terminal-friendly way nbdime nbdiff works as a git diff tool: https://nbdime.readthedocs.io/en/latest/#git-integration-quickstart nbmerge: three-way merge of notebooks with automatic conflict resolution nbdime nbmerge works as a git merge tool nbdiff-web: shows you a rich rendered diff of notebooks nbmerge-web: gives you a web-based three-way merge tool for notebooks nbshow: present a single notebook in a terminal-friendly way

我还将添加到其他人建议的https://nbdev.fast.ai/，这是一个最先进的“文学编程环境，正如Donald Knuth在1983年所设想的那样!”

它也有一些git钩子，可以帮助https://nbdev.fast.ai/#Avoiding-and-handling-git-conflicts和其他命令，如:

nbdev_read_nbs nbdev_clean_nbs nbdev_diff_nbs nbdev_test_nbs

所以你也可以创建你的文档，就像在写一个库，例如:

https://dev.fast.ai/ https://ohmeow.github.io/blurr/ https://rbracco.github.io/fastai2_audio/

除了第一个链接，您还可以在这里看到一个视频nbdev教程。

下面是Cyrille rosant为IPython 3.0提供的一个新解决方案，它坚持标记文件，而不是基于json的ipymd文件:

https://github.com/rossant/ipymd

不幸的是，我对Mercurial了解不多，但我可以为您提供一个与Git一起工作的可能解决方案，希望您能够将我的Git命令转换为对应的Mercurial命令。

对于后台，在Git中，add命令将对文件所做的更改存储到暂存区域。完成此操作后，Git将忽略对文件的任何后续更改，除非您告诉它也执行这些更改。因此，下面的脚本，对于每个给定的文件，剥离所有的输出和prompt_number部分，运行剥离的文件，然后恢复原始文件:

注意:如果运行此命令会得到类似ImportError的错误消息:没有名为IPython的模块。Nbformat，然后使用ipython而不是python来运行脚本。

from IPython.nbformat import current
import io
from os import remove, rename
from shutil import copyfile
from subprocess import Popen
from sys import argv

for filename in argv[1:]:
    # Backup the current file
    backup_filename = filename + ".backup"
    copyfile(filename,backup_filename)

    try:
        # Read in the notebook
        with io.open(filename,'r',encoding='utf-8') as f:
            notebook = current.reads(f.read(),format="ipynb")

        # Strip out all of the output and prompt_number sections
        for worksheet in notebook["worksheets"]:
            for cell in worksheet["cells"]:
               cell.outputs = []
               if "prompt_number" in cell:
                    del cell["prompt_number"]

        # Write the stripped file
        with io.open(filename, 'w', encoding='utf-8') as f:
            current.write(notebook,f,format='ipynb')

        # Run git add to stage the non-output changes
        print("git add",filename)
        Popen(["git","add",filename]).wait()

    finally:
        # Restore the original file;  remove is needed in case
        # we are running in windows.
        remove(filename)
        rename(backup_filename,filename)

一旦脚本在您想要提交的文件上运行，只需运行git commit。

在删除笔记本的输出数年之后，我试图提出一个更好的解决方案。我现在使用Jupytext，这是我设计的Jupyter Notebook和Jupyter Lab的扩展。

Jupytext可以转换Jupyter笔记本到各种文本格式(脚本，Markdown和R Markdown)。反之。它还提供了将笔记本与这些格式之一配对的选项，并自动同步笔记本的两种表示形式(.ipynb和.md/.py/)。R文件)。

让我来解释一下Jupytext是如何回答上述问题的:

允许我在包含或不包含输出之间进行选择，

。海事/ . py。R文件只包含输入单元格。您应该始终跟踪该文件。只有在希望跟踪输出时，才对.ipynb文件进行版本控制。

防止我不小心提交输出，如果我不想要它，

将 *.ipynb 添加到 .gitignore

允许我保持本地版本的输出，

输出保存在(local) .ipynb文件中

允许我看到当我使用我的版本控制系统在输入中有变化时(即，如果我只控制输入，但我的本地文件有输出，那么我希望能够看到输入是否发生了变化(需要提交)。使用版本控制状态命令将总是注册一个差异，因为本地文件有输出。)

.py/。R或。md文件是你要找的

允许我从更新的干净笔记本更新我的工作笔记本(其中包含输出)。(更新)

获取.py/. xml文件的最新修订版本。R或。md文件，并刷新你的笔记本在Jupyter (Ctrl+R)。您将从文本文件中获得最新的输入单元格，并从.ipynb文件中获得匹配的输出。内核不受影响，这意味着您的局部变量被保留-您可以继续在离开它的地方工作。

我喜欢Jupytext的地方是它的笔记本(以.py/。R或.md文件)可以在您喜欢的IDE中编辑。使用这种方法，重构笔记本变得很容易。一旦你完成了，你只需要在Jupyter刷新笔记本。

如果你想尝试一下:安装Jupytext与pip安装Jupytext并重新启动你的Jupyter笔记本或实验室编辑器。打开要进行版本控制的笔记本，并使用Jupyter notebook中的Jupytext菜单(或Jupyter Lab中的Jupytext命令)将其配对到Markdown文件(或脚本)。保存您的笔记本，您将得到两个文件:原始的.ipynb，加上承诺的笔记本文本表示，这非常适合版本控制!

对于那些可能感兴趣的人:在命令行上也可以使用Jupytext。