直接备份 .jupyter 目录可还原绝大部分配置，但主题、字体、扩展等需单独备份 ~/.jupyter/custom/ 下的 custom.css、current_theme.txt 和 fonts/；Docker 环境应挂载该目录而非依赖镜像备份。
直接备份 jupyter_notebook_config.py 文件就能还原绝大部分配置，但必须注意它不包含主题、字体、扩展等用户级设置——这些得单独处理。
备份核心配置文件：jupyter_notebook_config.py
这个文件控制端口、默认目录、安全设置等关键行为。它不是自动生成的，只有执行过 jupyter notebook --generate-config 才会出现。
- 先确认路径：运行
jupyter --config-dir，输出类似/home/username/.jupyter，配置文件就在该目录下，名为jupyter_notebook_config.py - 备份时直接复制整个
.jupyter目录更稳妥，因为里面还可能有jupyter_nbconvert_config.py或jupyter_lab_config.py - Windows 用户注意：路径里含中文或空格时，
notebook_dir配置值要用原始字符串写法，比如c.NotebookApp.notebook_dir = r'D:\my notebooks'，否则启动失败
还原时别漏掉主题和字体配置
jupyter-themes 的设置不会写进 jupyter_notebook_config.py，而是存在 ~/.jupyter/custom/ 下，还原后若主题消失，不是配置没生效，是这部分被忽略了。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 必须一并备份
~/.jupyter/custom/custom.css和~/.jupyter/custom/current_theme.txt - 如果用了自定义字体，
~/.jupyter/custom/fonts/目录也要复制过去 - 还原后需重启 Jupyter 服务，仅刷新浏览器无效；若 CSS 不生效，检查浏览器缓存或尝试加
?v=1强制重载
容器环境里备份要分两层
在 Docker 中跑 Jupyter（如 quay.io/jupyter/scipy-notebook），配置文件虽然在容器内，但不能只备份容器镜像——镜像不保存用户修改，且体积大、恢复慢。
- 正确做法：把
/root/.jupyter（root 用户）或/home/jovyan/.jupyter（默认用户）挂载为卷，宿主机上直接备份该目录 - 命令示例：
docker run -v $(pwd)/jupyter-config:/home/jovyan/.jupyter ...，这样宿主机的jupyter-config就是完整备份源 - 切勿依赖
docker commit做配置备份——它会把临时文件、日志、缓存全打包进去，下次启动可能因权限或路径问题失败
最易被忽略的是：jupyter_notebook_config.py 里的路径配置（如 notebook_dir）在不同机器上很可能失效，还原后务必检查路径是否存在、权限是否可读写，尤其是 Windows 和 Linux 之间迁移时，斜杠方向和盘符逻辑完全不同。
