应修改c.NotebookApp.autosave_interval参数，单位毫秒，默认120000（2分钟），推荐设为30000–60000；永久生效需编辑~/.jupyter/jupyter_notebook_config.py添加配置，临时调试可在浏览器Console执行Jupyter.notebook.set_autosave_interval()。
怎么改 c.NotebookApp.autosave_interval 参数
这个参数控制前端 JavaScript 定时器的触发间隔，单位是毫秒，默认值 120000（即 2 分钟）。它不是“每 N 秒强制写一次”，而是“用户停止编辑后等待 N 毫秒再发起保存请求”。所以调太短（比如 5000）反而容易被频繁中断，导致无效请求堆积。
修改方式只有两种有效路径：
- 永久生效：编辑
~/.jupyter/jupyter_notebook_config.py，添加一行c.NotebookApp.autosave_interval = 60000（推荐设为 30000–60000） - 临时调试：在浏览器 Console 里执行
Jupyter.notebook.set_autosave_interval(30000)，刷新即失效
注意：不要改 autosave 前端变量或重写 JS 脚本——Jupyter 5.0+ 已移除直接暴露该对象的接口，强行操作会报 undefined 错误。
为什么改了配置却没生效
常见原因不是参数写错，而是配置文件没被加载。Jupyter 启动时只读取一个配置文件，且优先级固定：
- 启动命令带
--config指定路径 → 用那个文件 - 否则查
jupyter --config-dir输出的目录 → 默认是~/.jupyter - 确认文件名是
jupyter_notebook_config.py，不是jupyter_config.py或拼错 - 重启 Jupyter 服务（不是刷新页面），否则新配置不加载
验证是否生效：打开任意 Notebook，在浏览器 Console 执行 Jupyter.notebook.get_autosave_interval()，返回值应与你设置的毫秒数一致。
自动保存和检查点（checkpoint）的区别
很多人以为调短 autosave_interval 就能回滚历史版本，其实不能。自动保存只更新主 .ipynb 文件；而检查点（.ipynb_checkpoints/ 目录下的备份）只在手动点击 Save and Checkpoint 或首次创建时生成，不会随自动保存同步更新。
- 自动保存失败时，检查点仍是上一次手动保存的状态
- 想靠检查点恢复“刚删掉的 cell”？必须提前点过
Save and Checkpoint - 检查点文件默认存在同级隐藏目录
.ipynb_checkpoints/，别误删
也就是说，autosave_interval 只管“最近一次编辑能不能落盘”，不管“能不能回到三分钟前”。真要版本控制，得配 Git 或用 nbstripout 过滤输出后再提交。
30 秒 vs 60 秒：I/O 压力到底有多大
在 SSD 或云盘（如 AWS EBS gp3、阿里云ESSD）上，60 秒间隔几乎无感知；但如果你的 Notebook 包含大量图像输出（比如每次绘图都 embed PNG），30 秒可能引发明显卡顿——因为每次保存都是全量序列化整个 JSON，不是增量 diff。
- 一个含 20 张 1MB 图表的 Notebook，单次保存约写入 25MB+，30 秒频次下每分钟 I/O 达 50MB
- 机械硬盘或 NFS 共享存储上，建议不低于 60000，否则页面响应延迟明显
- 容器环境（如
pytorch-cuda:v2.7）中，还要看挂载卷的 fsync 行为，某些 overlayfs 实现会放大延迟
真正容易被忽略的是：自动保存依赖前端定时器，一旦浏览器标签页被系统休眠、后台冻结（比如 macOS 的 Safari 自动清理），计时器就停摆——此时哪怕设成 5 秒也没用。所以高风险实验，仍要养成运行 cell 后手动按 Ctrl+S 的习惯。
