如何设置Jupyter自动将notebook同步保存为纯Python(.py)副本文件

方案1：使用Jupyter内置的保存后钩子实现（无需额外安装扩展） #

这是最轻量化的原生实现方案，不需要额外安装第三方扩展：

• 首先在终端执行命令jupyter notebook --generate-config生成Jupyter配置文件，默认生成路径为用户目录下的.jupyter/jupyter_notebook_config.py
• 打开配置文件，添加以下代码段：

import os
from subprocess import check_call

def post_save(model, os_path, contents_manager):
    # 仅处理notebook类型文件
    if model['type'] != 'notebook':
        return
    dir_name, file_name = os.path.split(os_path)
    base_name, ext = os.path.splitext(file_name)
    if ext != '.ipynb':
        return
    # 导出无提示符的纯Python代码文件
    check_call(['jupyter', 'nbconvert', '--to', 'python', '--no-prompt', os_path], cwd=dir_name)

c.FileContentsManager.post_save_hook = post_save

• 重启Jupyter服务即可生效，后续每次保存.ipynb文件时，都会自动在同目录下生成同名的.py代码副本。

方案2：使用Jupytext扩展实现（生产级稳定方案，支持自定义规则） #

这个方案是团队协作场景的常用选择，同步逻辑更稳定，可配置项更丰富：

• 首先执行安装命令pip install jupytext
• 启动Jupyter后打开任意Notebook，点击菜单栏File -> Jupytext -> Pair Notebook with ipynb and py:percent，后续保存时就会自动同步同名.py文件，默认会保留代码注释、过滤Markdown单元格和运行输出内容，适配生产代码要求。
• 团队全局使用可以修改Jupyter配置文件添加如下规则，所有新建Notebook默认自动同步.py文件，无需逐个手动设置：

c.Jupytext.default_formats = "ipynb,py:percent"

配套优化建议 #

• 可以在导出逻辑中添加black、ruff等代码格式化工具调用，自动对齐生产环境的代码规范
• 可以配置.gitignore忽略.ipynb文件的输出缓存，版本控制仅提交生成的.py文件和无输出的.ipynb源文件，大幅降低代码仓库体积
• 上述两个方案对Jupyter Notebook和Jupyter Lab都完全兼容，配置逻辑一致

内容的提问来源于stack exchange，提问作者AffableAmbler