nbextensions 插件启用状态由 ~/.jupyter/nbconfig/notebook.json 中的 "enabled": true 字段决定，而非 jupyter_notebook_config.py；该文件由 jupyter nbextension enable 命令自动生成，前端加载依赖 JS 文件存在、配置器已启用及兼容性选项关闭。
nbextensions 配置文件本身不控制插件开关
直接修改 Jupyter 的配置文件（如 jupyter_notebook_config.py）无法启用或禁用具体 nbextensions 插件。这些插件的启用状态由前端 JS 文件的加载逻辑和后端 Python 模块的注册共同决定，不是靠配置项开关的。你看到的“Nbextensions”选项卡及其勾选状态，本质是前端界面读取 ~/.jupyter/nbconfig/notebook.json 中的 JSON 配置来渲染的——这个文件是插件启用操作（jupyter nbextension enable）写入的，不是手动编辑的目标。
真正起作用的是 nbconfig 目录下的 JSON 文件
插件是否生效，取决于 ~/.jupyter/nbconfig/notebook.json 里对应扩展的 "enabled": true 字段。这个文件由命令自动生成，**不要手写**，否则容易格式错误或字段冲突。例如启用 Table of Contents (2)，执行：
jupyter nbextension enable --py --sys-prefix toc2
就会在 notebook.json 中写入类似内容：
{
"load_extensions": {
"toc2/main": true
}
}
-
--sys-prefix和--user决定写入哪个环境的配置：conda 环境常用--sys-prefix，pip 全局安装常用--user - 如果插件名含斜杠（如
toc2/main），必须按实际路径写，大小写敏感 - 重复执行
enable不会报错，但disable会把对应字段设为false或删掉
为什么改 jupyter_notebook_config.py 没用？
这个 Python 配置文件只控制 Notebook 服务本身的启动行为（如端口、密码、自动打开浏览器等），它不解析或传递插件启用指令。常见误区是往里面加类似 c.NotebookApp.nbserver_extensions = {'jupyter_nbextensions_configurator': True} ——这仅让配置器后端模块加载，但不会激活任何前端插件，也不会生成 nbconfig/notebook.json。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
真正需要这行配置的场景极少，仅当你要在非标准路径部署配置器时才可能涉及；绝大多数用户只需确保 jupyter_nbextensions_configurator 已通过 jupyter nbextension enable --py 启用即可。
遇到插件不生效，先检查这三个位置
插件看似勾选了却没反应，问题通常不在配置文件，而在以下环节：
- 前端资源未安装：
jupyter contrib nbextension install --user没运行，导致 JS/CSS 文件根本不在~/.local/share/jupyter/nbextensions/下 - 配置器没启用：
jupyter nbextension enable --py jupyter_nbextensions_configurator --user缺失，顶部菜单栏就不会出现 “Nbextensions” 标签 - 兼容性限制开着：Jupyter 默认勾选 “Disable configuration for nbextensions without explicit compatibility”，Table of Contents、Variable Inspector 等主流插件会直接灰显——必须进 Nbextensions 页面手动取消该勾选
这些环节漏掉任何一个，都会导致你改了配置也白搭。
