首页 > 软件数据恢复 > Jupyter Notebook(.ipynb)文件丢失恢复：未保存、崩溃、误删、Git冲突完整解决方案

Jupyter Notebook(.ipynb)文件丢失恢复：未保存、崩溃、误删、Git冲突完整解决方案

2026-08-01 软件数据恢复

Jupyter Notebook(.ipynb)文件丢失恢复：未保存、崩溃、误删、Git冲突完整解决方案

Jupyter Notebook是数据科学、机器学习和科学计算领域最常用的交互式编程环境。当.ipynb文件因崩溃、误删、Git冲突等原因丢失时，可能意味着数小时甚至数天的分析工作付之东流。本文将全面介绍Jupyter Notebook文件的恢复方法。

一、理解Jupyter Notebook文件结构

1.1 .ipynb文件格式

Jupyter Notebook文件是JSON格式的文本文件，包含以下核心内容：

  • cells：代码单元格和Markdown单元格
  • metadata：内核信息、Notebook版本等
  • nbformat：文件格式版本号
  • outputs：代码执行输出结果

1.2 检查点（Checkpoint）机制

Jupyter自动创建检查点文件，默认每120秒保存一次。检查点存储在隐藏目录中：

.ipynb_checkpoints/
├── your_notebook-checkpoint.ipynb
└── another_notebook-checkpoint.ipynb

这个机制是恢复数据的关键。

二、Jupyter Notebook未保存恢复

2.1 场景一：浏览器崩溃或意外关闭

步骤1：检查检查点文件

在Notebook文件所在目录，查找.ipynb_checkpoints隐藏文件夹：

# Linux/macOS
ls -la .ipynb_checkpoints/

# Windows (在文件资源管理器中开启"显示隐藏文件")
dir .ipynb_checkpoints /a

找到-checkpoint.ipynb文件后，复制一份并重命名即可恢复。

步骤2：检查Jupyter运行目录

如果Jupyter服务器还在运行，可以通过浏览器重新访问：

http://localhost:8888/

未关闭的Notebook标签页可能仍然保留在内存中。

2.2 场景二：Jupyter内核崩溃

内核崩溃不会丢失Notebook文件本身，但未执行的输出会丢失。

恢复方法：

  1. 重新启动Jupyter服务器
  2. 打开原来的Notebook文件
  3. 重新执行需要的单元格

2.3 场景三：电脑死机/断电

方法1：查找检查点

同场景一，检查.ipynb_checkpoints目录。

方法2：检查Jupyter日志

# 查看Jupyter运行日志
cat ~/.jupyter/jupyter.log

# 或查看系统日志
journalctl --user -u jupyter-notebook

三、.ipynb文件损坏修复

3.1 JSON格式损坏修复

.ipynb文件本质是JSON，如果JSON格式损坏，Notebook将无法打开。

方法1：使用Python修复

import json

# 尝试读取损坏的文件
try:
    with open('damaged.ipynb', 'r', encoding='utf-8') as f:
        content = f.read()
    
    # 尝试修复常见JSON问题
    # 移除BOM标记
    if content.startswith('\ufeff'):
        content = content[1:]
    
    # 尝试解析
    notebook = json.loads(content)
    
    # 保存修复后的文件
    with open('recovered.ipynb', 'w', encoding='utf-8') as f:
        json.dump(notebook, f, ensure_ascii=False, indent=1)
    
    print("修复成功！")
except json.JSONDecodeError as e:
    print(f"JSON解析错误: {e}")
    print(f"错误位置: 第{e.lineno}行, 第{e.colno}列")

方法2：手动修复JSON

用文本编辑器打开.ipynb文件，检查：

  • 是否有未闭合的引号
  • 是否有多余或缺少的逗号
  • 括号是否匹配
  • 编码是否正确（应为UTF-8）

方法3：使用nbformat工具

pip install nbformat

# 验证notebook格式
python -m nbformat validate damaged.ipynb

# 尝试转换修复
jupyter nbconvert --to notebook --output recovered.ipynb damaged.ipynb

3.2 文件编码问题

如果.ipynb文件编码被改变（如从UTF-8变为GBK），可能导致打开乱码。

修复方法：

# 尝试不同编码读取
encodings = ['utf-8', 'utf-8-sig', 'gbk', 'gb2312', 'latin-1']
for enc in encodings:
    try:
        with open('damaged.ipynb', 'r', encoding=enc) as f:
            content = f.read()
        json.loads(content)
        print(f"成功: 编码为 {enc}")
        break
    except:
        continue

四、误删.ipynb文件恢复

4.1 从Git历史恢复

如果使用了Git版本控制：

# 查看文件历史
git log -- path/to/notebook.ipynb

# 恢复到最后提交的版本
git checkout HEAD -- path/to/notebook.ipynb

# 恢复到特定提交版本
git checkout  -- path/to/notebook.ipynb

# 如果文件已暂存删除，从暂存区恢复
git restore --staged path/to/notebook.ipynb
git restore path/to/notebook.ipynb

4.2 从Jupyter检查点恢复

即使原文件被删除，检查点文件可能仍然存在：

# 查找所有检查点文件
find . -name "*-checkpoint.ipynb" -type f

# 复制检查点文件为正式文件
cp .ipynb_checkpoints/notebook-checkpoint.ipynb ./notebook.ipynb

4.3 使用数据恢复软件

如果检查点也不存在，使用专业数据恢复工具：

推荐工具：

  • TestDisk/PhotoRec（免费开源，跨平台）
  • DiskGenius（国产，支持多种文件系统）
  • R-Studio（专业级，恢复率高）
  • Recuva（Windows免费，操作简单）

操作步骤（以TestDisk为例）：

# 安装TestDisk
sudo apt install testdisk  # Linux
brew install testdisk      # macOS

# 运行恢复
sudo testdisk

# 选择磁盘 → 选择分区类型 → 选择Analyse → 搜索丢失文件
# 找到.ipynb文件后，复制到安全位置

五、Git冲突导致的Notebook丢失

5.1 问题说明

.ipynb文件在Git合并时容易产生冲突，因为JSON格式的差异对比不够直观。

5.2 解决冲突

方法1：使用nbdime工具

pip install nbdime

# 配置Git使用nbdime处理notebook差异
nbdime config-git --enable global

# 合并冲突时，nbdime会提供可视化对比界面

方法2：手动解决冲突

  1. 用文本编辑器打开冲突的.ipynb文件
  2. 找到<<<<<<<、=======、>>>>>>>标记
  3. 选择保留正确的版本内容
  4. 删除冲突标记
  5. 验证JSON格式正确性

方法3：使用JupyterLab Git扩展

JupyterLab的Git扩展提供了更友好的notebook合并界面，可以逐单元格对比和选择。

5.3 预防Git冲突

# 在.gitconfig中设置notebook的合并策略
git config --global merge.tool nbdime
git config --global mergetool.nbdime.cmd 'nbmerge $BASE $LOCAL $REMOTE $MERGED'

# 或使用nbstripout去除输出后再提交
pip install nbstripout
nbstripout --install

六、云端Jupyter环境数据恢复

6.1 JupyterHub/企业环境

联系管理员检查：

  • 用户主目录的备份
  • Docker容器的持久化卷
  • Kubernetes PV/PVC数据

6.2 Google Colab

Colab的Notebook自动保存到Google Drive：

  1. 检查Google Drive中的"Colab Notebooks"文件夹
  2. 查看Google Drive的回收站（30天内可恢复）
  3. 检查"版本历史"功能

6.3 Kaggle Notebooks

Kaggle Notebook的输出和代码会自动保存：

  1. 在Kaggle的"Your Work"中查找
  2. 检查版本历史（每个commit都可恢复）

七、预防措施和最佳实践

7.1 启用自动保存和版本控制

# 在Jupyter配置中设置更频繁的自动保存
# ~/.jupyter/jupyter_notebook_config.py
c.FileContentsManager.checkpoints_kwargs = {'checkpoint_interval': 60}  # 60秒

7.2 使用Git进行版本管理

# 初始化Git仓库
git init
git add *.ipynb
git commit -m "Initial commit"

# 使用nbstripout去除输出，减少仓库体积
pip install nbstripout
nbstripout --install

7.3 定期导出备份

# 在Notebook中添加自动备份代码
import shutil
from datetime import datetime

def backup_notebook():
    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
    backup_path = f"backup/notebook_backup_{timestamp}.ipynb"
    shutil.copy("__notebook_source__.ipynb", backup_path)
    print(f"备份已保存: {backup_path}")

7.4 使用云同步服务

将Notebook目录放在云同步文件夹中：

  • 坚果云（国内推荐）
  • OneDrive
  • Dropbox
  • Google Drive

八、总结

Jupyter Notebook文件恢复的关键在于：

  1. 检查点文件是第一道防线 — 始终先检查.ipynb_checkpoints目录
  2. Git是最佳保护 — 养成频繁commit的习惯
  3. JSON格式可手动修复 — 了解.ipynb的结构有助于手动修复
  4. 云端环境有自带恢复 — 利用平台的历史版本功能
  5. 预防胜于恢复 — 自动保存+版本控制+云同步三重保障

掌握这些方法，即使遇到Notebook丢失的情况，也能从容应对，最大限度减少数据损失。

数据丢失不要慌，专业工具帮您恢复

支持硬盘、U 盘、SD 卡、手机等多种设备的数据恢复

免费下载试用

相关文章推荐