如何保存不含本地内核信息的Jupyter Notebook避免PR测试报错

该报错的本质是本地conda环境的内核名称被写入了Notebook的元数据中，CI/其他设备不存在对应内核导致加载失败，可通过以下方案从根本上避免本地环境信息被写入Notebook：

• 方案1：配置Jupyter全局保存钩子，自动覆盖内核元数据
  操作步骤：
  1. 执行命令生成Jupyter配置文件（已生成可跳过）：jupyter notebook --generate-config
  2. 打开生成的jupyter_notebook_config.py文件，添加以下代码：

  def clean_kernelspec(model, **kwargs):
      if model['type'] != 'notebook':
          return
      nb = model['content']
      # 统一内核名为通用python3，删除环境相关显示名
      nb['metadata']['kernelspec'] = {
          "display_name": "Python 3",
          "language": "python",
          "name": "python3"
      }
  c.FileContentsManager.pre_save_hook = clean_kernelspec
  

  配置完成后，所有本地保存的Notebook都会自动使用通用内核配置，不会写入本地环境信息。
• 方案2：配置Git提交自动清理Notebook元数据
  适用于多开发者协作的项目，所有提交都会自动过滤本地信息：
  1. 安装清理工具：pip install nbstripout
  2. 在项目根目录执行命令配置Git过滤器：nbstripout --install
     配置后每次提交代码时，工具会自动清除Notebook中的内核信息、执行计数、代码输出等本地专属内容，仅保留代码和Markdown文本。
• 方案3：编辑完成后手动切换通用内核再保存
  无需额外配置的临时方案：编辑完Notebook后，点击界面菜单栏「Kernel」→「Change Kernel」，选择通用的Python 3 (ipykernel)选项，之后再保存Notebook即可，此时写入的内核名称为通用python3。
• 方案4：批量清理已有Notebook的本地元数据
  如果已经生成了带本地内核信息的Notebook，可执行命令一键清理：
  jupyter nbconvert --to notebook --inplace --ClearMetadataPreprocessor.enabled=True 待清理的文件名.ipynb

经过上述方案处理的Notebook，在任意设备打开时都会自动适配当前环境的默认Python内核，不会出现找不到本地内核的报错。

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