VSCode使用Jupyter Notebook时检查点文件未存入.ipynb_checkpoints问题

该问题属于VSCode Jupyter扩展的常见配置冲突问题，大量用户都反馈过同类现象，可按以下步骤排查解决：

1 调整扩展备份模式配置 #

• 打开VSCode设置界面，搜索配置项 Jupyter: Notebook File Backup Mode
• 将默认的backup选项修改为以下两种之一：
  • checkpoints：扩展备份将直接写入Jupyter原生的.ipynb_checkpoints文件夹，不会散落在工作目录
  • off：完全关闭扩展自带的备份机制，仅使用Jupyter原生检查点功能保存历史版本

2 修复检查点文件夹权限 #

如果修改配置后问题仍然存在，大概率是当前用户对.ipynb_checkpoints文件夹没有写入权限，导致备份文件 fallback 写入工作目录根路径：

• 先删除已生成的所有带UUID的冗余ipynb文件
• 手动在工作目录新建.ipynb_checkpoints文件夹（如果已存在则跳过）
• 给文件夹开通读写权限：
  • Windows：右键文件夹→属性→安全→编辑当前用户权限，勾选读取、写入权限后保存
  • macOS/Linux：在工作目录打开终端，执行命令 chmod 755 .ipynb_checkpoints

3 重置Jupyter扩展配置 #

如果前两个方案无效，可直接重置扩展配置解决异常：

• 打开VSCode扩展面板，找到「Jupyter」扩展，右键选择「重置设置」
• 重启VSCode后即可恢复默认正常逻辑

批量清理冗余文件命令（可选） #

如果已经生成大量冗余文件，可使用命令批量筛选删除，无需手动操作：

• Windows Powershell：Get-ChildItem -Path . -Filter "*-*-*-*-*.ipynb" | Remove-Item
• macOS/Linux终端：rm *-*-*-*-*.ipynb
  执行命令前建议先执行筛选命令（Windows去掉| Remove-Item，Linux去掉rm）确认匹配文件均为冗余备份，避免误删正常笔记本

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