如何清除Jupyter Notebook保存的widget状态适配Git版本管理

你遇到的前端取消勾选"Save Widget state automatically"不生效的问题，是Jupyterlab 3.4.2搭配jupyterlab_widgets 1.1.0版本的已知配置同步bug：图形化设置页的勾选状态不会同步到后端保存逻辑，哪怕重启内核，保存文件时依然会默认把widget状态写入notebook的JSON结构，手动删字段后自动恢复也是同一个原因。

以下两种方案都可以直接在Jupyter Lab内部操作生效，不需要依赖外部预提交钩子：

全局永久禁用（对所有notebook生效） #

• 打开Jupyter Lab，进入Settings -> Advanced Settings Editor
• 左侧设置分类选择Notebook，切换到JSON配置编辑模式（不要用默认的图形化表单，表单配置同步bug就是之前操作失效的核心原因）
• 在右侧用户自定义配置区域填入以下配置：

{
  "saveWidgetState": false
}

• 完全退出Jupyter Lab进程后重新启动，打开目标notebook，先执行Kernel -> Restart Kernel and Clear All Outputs，再保存文件即可。

配置生效后，所有notebook保存时都不会再写入widget状态，从根源解决.ipynb文件因为widget状态随机变动产生大量无意义Git diff的问题。

单文件级禁用（仅对当前纳入Git管理的notebook生效） #

如果不想全局关闭功能，只需要给特定版本库的notebook关闭状态保存：

• 打开目标notebook，点击顶部菜单Edit -> Edit Notebook Metadata
• 在弹出的元数据编辑框里，先删除已有的widgets顶级字段，再在metadata层级下添加配置项："save_widget_state": false
• 保存元数据后重启内核、清空所有输出再保存文件，后续该文件保存时不会再自动恢复widgets字段。

生效验证 #

保存后可以用文本编辑器直接打开对应.ipynb文件，检查JSON结构中不存在顶级widgets字段，即代表配置生效。

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