必须先运行jupyter notebook --generate-config生成配置文件,再修改c.notebookapp.notebook_dir路径;确保路径存在、无注释缩进、无不可见字符,且不被快捷方式参数或命令行--notebook-dir覆盖。

配置文件路径是否正确生成
没生成 jupyter_notebook_config.py 就直接去改,当然不生效。必须先运行 jupyter notebook --generate-config,它才会在 ~/.jupyter/(Windows 是 %USERPROFILE%.jupyter)下创建该文件。
常见错误是:命令执行后没注意输出的路径,或者误以为安装即自带配置文件。尤其用 Anaconda Prompt 启动时,~ 指向的是当前用户目录,不是 Anaconda 安装目录。
- 运行
jupyter --config-dir确认实际配置目录 - 检查该目录下是否存在
jupyter_notebook_config.py,而不是jupyter_config.py或其他名字 - 若存在多个
.jupyter目录(比如在不同 Python 环境下生成过),优先以jupyter --config-dir输出为准
c.NotebookApp.notebook_dir = '...' 这行有没有写错
这行必须取消注释、无缩进、路径存在、且单引号内不能有中文全角符号或多余空格。很多失效是因为复制粘贴时带了不可见字符,或路径末尾多了空格。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 删掉行首所有空格和
#,确保是顶格写的c.NotebookApp.notebook_dir = 'D:\mybooks' - 路径必须已存在,Jupyter 不会自动创建目录;不存在时它会静默回退到默认路径
- Windows 下推荐用双反斜杠
\或原始字符串前缀r'D:mybooks',避免被转义 - 不要用
u''前缀(Python 3.6+ 已不需要),也不要写成"D:/mybooks"(虽然部分情况能工作,但跨平台兼容性差)
快捷方式“目标”字段是否覆盖了配置
Windows 用户最容易忽略这点:开始菜单里的 Jupyter 快捷方式,“目标”字段末尾常带 %USERPROFILE% 或 %HOMEPATH%,这会强制覆盖配置文件设置,优先级高于 jupyter_notebook_config.py。
- 右键快捷方式 → 属性 → 查看“目标”栏,如果结尾是
"C:...jupyter-notebook.exe" %USERPROFILE%,就删掉%USERPROFILE%及其前面的空格 - 同样检查“起始位置”字段,它应为空或指向你希望的根目录(如
D:mybooks),否则也会影响行为 - 改完保存,**必须重新点击该快捷方式启动**,终端里手动运行
jupyter notebook不受此影响
启动时有没有传入命令行参数
命令行启动时如果带了 --notebook-dir=...,它会完全忽略配置文件里的 c.NotebookApp.notebook_dir,优先级最高。
- 检查你常用的启动方式:是双击快捷方式?还是在终端输
jupyter notebook?或是写了批处理脚本? - 终端中运行
jupyter notebook --help,看默认参数说明里是否显示--notebook-dir已被显式指定 - 临时测试可加
--no-browser --debug启动,日志开头会打印实际生效的notebook_dir值,一眼就能确认来源










