WSL2环境下VSCode预览Jupyter Notebook关闭时触发未保存更改警告的问题

原因 #

• VSCode Notebook的渲染特性：打开.ipynb文件时，编辑器会自动解析文件并生成临时渲染数据，部分场景下会触发文件元数据（如单元格视图状态、编辑器配置）的微小变更，这些变更会被标记为未保存。
• Git换行符自动转换：若本地与远程仓库的换行符配置不一致（比如本地用CRLF、远程用LF），git pull后Git会自动转换文件换行符，VSCode会将这种转换识别为文件内容变更。
• Jupyter扩展缓存冲突：VSCode的Jupyter扩展可能存在缓存异常，打开文件时加载旧缓存数据，与当前文件对比后误判为存在更改。

解决方法 #

• 双击打开文件而非预览：在VSCode文件资源管理器中双击.ipynb文件，避免单击触发的预览模式将临时渲染状态误标记为文件更改。
• 统一Git换行符配置：在项目根目录创建.gitattributes文件，添加内容：

  *.ipynb text eol=lf
  

  （可根据实际需求将lf改为crlf），强制统一Notebook文件的换行符规则，避免Git自动转换引发的变更标记。
• 清除Jupyter扩展缓存：打开VSCode命令面板（快捷键Ctrl+Shift+P/Cmd+Shift+P），执行Jupyter: Clear Jupyter Cache命令，清除缓存后重启VSCode。
• 检查并清理文件元数据：用纯文本编辑器打开.ipynb文件，对比Git仓库中的原始版本，查看metadata字段是否存在不必要的变更（如kernelspec、language_info的细微调整），若有可手动移除后提交到仓库，避免后续打开时重复触发变更标记。

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