jupyter notebook --generate-config 是唯一可靠方式,它创建 jupyter_notebook_config.py 并显示路径;新版 jupyter(7.0+)虽用双配置文件协同,但该命令仍只生成后者,需注意启动后端是 notebookapp 还是 serverapp 以确保配置生效。

jupyter notebook --generate-config 是唯一可靠的方式,它会创建 jupyter_notebook_config.py 文件,并告诉你具体路径。
如果你执行后没看到文件,大概率是命令没生效、权限不足,或者你用的是新版 Jupyter(7.0+)——它默认用 jupyter_server_config.py 和 jupyter_notebook_config.py 两个文件协同工作,但 --generate-config 仍只生成后者。
执行命令后没生成文件?检查这几点
常见现象:jupyter notebook --generate-config 运行后终端只闪一下就退出,或提示“command not found”
- 确认 Python 环境已激活:如果你用 Anaconda,先打开 Anaconda PowerShell Prompt(不是普通 CMD),再运行命令
- 检查
jupyter是否在 PATH 中:运行which jupyter(macOS/Linux)或where jupyter(Windows),若无输出,说明未正确安装或环境变量未加载 - 路径权限问题:Windows 下如果以普通用户运行,但
.jupyter目录在C:UsersXXX.jupyter,而该目录被系统保护,可尝试加--allow-root(仅调试用,不推荐长期使用) - 注意输出最后一行:成功时一定会显示
Writing default config to: xxx/jupyter_notebook_config.py—— 这就是你要找的路径
为什么改了配置文件却没生效?
最常踩的坑是:你以为改的是 Jupyter Notebook 的配置,实际启动的是 Jupyter Server(尤其在 VS Code 内置 Jupyter 或 JupyterLab 4+ 环境下)
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- Jupyter Notebook 6.x 及更早版本读取
c.NotebookApp.xxx配置项 - Jupyter Server(7.0+ 默认后端)优先读取
c.ServerApp.xxx,比如c.ServerApp.notebook_dir才控制工作目录 - 如果你在
jupyter_notebook_config.py里写的是c.NotebookApp.notebook_dir = 'D:\notebooks',但在 Jupyter Server 模式下启动,这条会被忽略 - 解决办法:直接在
jupyter_notebook_config.py里同时写两行(兼容旧/新):c.NotebookApp.notebook_dir = 'D:\notebooks'c.ServerApp.notebook_dir = 'D:\notebooks'
配置文件在哪?别靠猜,用命令查
不要手动去 C:UsersXXX.jupyter 翻找,不同系统、不同安装方式路径可能不同
- 最稳的方法是运行:
jupyter --config-dir—— 它会准确输出配置目录路径 - 想看当前生效的完整配置(含继承关系):
jupyter notebook --show-config,注意这里输出的是最终合并结果,不是原始.py文件内容 - 如果
jupyter --config-dir报错,说明 Jupyter 核心未安装或损坏,先运行pip install jupyter或重装 Anaconda
jupyter_notebook_config.py 很可能只是个摆设——关键得看启动入口用的是 NotebookApp 还是 ServerApp。










