刚接触新版 Jupyter 的时候我最头疼的不是写代码而是每次打开 jupyter notebook 网页版浏览器里永远停在 C 盘用户目录想打开自己放代码的文件夹得先点好几次鼠标一层层跳进去或者打开之后老老实实执行一条cd /d D:\projects命令才能找到项目。后来换了新电脑装上新版 Anaconda 里的 Jupyter发现默认文件夹的问题又变了个花样配置文件改了没反应、网页版入口变成 JupyterLab、命令行启动和快捷方式启动读的还不是同一套配置。这篇文章我会把这些坑挨个踩一遍整理出一套适用于新版 Jupyter 的默认文件夹切换方案包括永久配置、临时启动、排查思路希望能帮你一次搞定。如果你只是想解决“我不想每次手动切目录”这个小问题那直接看第 2 章的配置文件修改方法就够了。如果你发现改完不生效或者遇到“启动 Jupyter 报 DLL 错误”“单元格执行没反应”这类热词里经常出现的情况那第 4 章的排查手册应该能省下不少折腾时间。1. 新版 Jupyter 默认文件夹为什么这么难搞1.1 新版界面的“双重身份”问题很多教程还在教你怎么改jupyter_notebook_config.py但你现在安装的 Jupyter 很可能已经不是当年那个单薄的网页编辑器了。新版 Jupyter 默认启动的是 JupyterLab它和旧版 Notebook 共用一套内核但界面、命令入口和部分配置项不完全一样。更麻烦的是如果你在 Windows 上装了 Anaconda后来又用 pip 补装过 jupyter 相关包系统里可能同时存在多个 Jupyter 入口Anaconda 自带的那个命令行启动器和你自己创建快捷方式启动的可能根本读的是不同环境的配置。这就解释了为什么很多人按照老教程操作改完c.NotebookApp.notebook_dir之后从开始菜单里点 Jupyter Notebook 没变化反而从命令行手动敲jupyter notebook却发现生效了。看起来是同一个软件实际上启动程序的工作目录、配置文件的搜索路径、依赖的 Python 环境都可能有差异。1.2 默认目录到底由谁决定要理解默认文件夹切换先得明白 Jupyter 启动时按什么顺序加载配置。正常情况下Jupyter 会依次查找几个位置的配置文件找到之后按优先级合并如果你在多个文件里配置了同一个参数后面的会覆盖前面的。对于新版来说最重要的配置文件是jupyter_notebook_config.py它通常位于用户目录下的.jupyter文件夹中在 Windows 上就是C:\Users\你的用户名\.jupyter\jupyter_notebook_config.py。在较新版本中与目录相关的配置项有两个老牌的c.NotebookApp.notebook_dir和新版推荐的c.ServerApp.root_dir。官方在新版中逐渐向ServerApp迁移但出于兼容性考虑NotebookApp依旧可用。我实测下来两个参数同时设置没有冲突如果只想写一个优先用ServerApp.root_dir这样无论是 JupyterLab 还是 Notebook 界面都能识别。理解了这一点你就能明白为什么光改一个地方有时候不生效——因为 JupyterLab 和 Notebook 启动器读取配置的入口并不完全一致稳妥的做法就是把两个配置项都写上一劳永逸。2. 最稳妥的永久切换方案修改配置文件2.1 找到并生成正确的配置文件永久修改默认文件夹的思路很简单让 Jupyter 启动时记住你想要的目录。但“写进配置文件”之前你要先确定这个配置文件到底在哪、当前命令行启动的 Jupyter 到底是哪个环境的。在 Windows 上我的操作习惯是先打开 CMD 或 PowerShell执行下面这条命令jupyter notebook --generate-config这条命令有两个作用如果配置文件已经存在它会提示是否覆盖如果不存在它会在当前用户目录下生成一个默认配置文件。执行完以后打开C:\Users\你的用户名\.jupyter\jupyter_notebook_config.py你能看到大量被注释掉的配置项其中就包含我们要修改的目录相关参数。不过这里有一个关键步骤容易被忽略如果你的系统里装了多个 Python 环境比如 Anaconda 和原生 Python 都有 Jupyter那要先确认 CMD 里执行的jupyter到底是哪一个。可以用下面的命令查看where jupyter如果输出结果里同时出现多个路径说明环境有冲突。遇到这种情况我建议在具体环境下用模块方式启动例如在 Anaconda Prompt 里执行python -m jupyter notebook --generate-config这样生成的配置文件一定属于当前激活的环境也就能避免路径混乱的问题。2.2 修改配置项并验证效果用记事本或 VS Code 打开配置文件后搜索notebook_dir或root_dir关键字你会看到默认被注释掉的配置行。取消注释并修改成你想要的目录这里重点强调一下 Windows 路径格式c.ServerApp.root_dir D:/JupyterProjects c.NotebookApp.notebook_dir D:/JupyterProjects注意我使用的是正斜杠这是避免转义问题最简单的方式。很多人第一次操作时会把路径写成D:\JupyterProjects在 Python 字符串里这个写法中的\J会被当成转义字符解析虽然很多情况下不报错但结果可能完全不是你想要的。如果非要写反斜杠必须写成双反斜杠D:\\JupyterProjects但既然正斜杠在 Windows 下完全兼容就没必要给自己找麻烦。保存配置文件后关闭所有 Jupyter 进程重新启动。正常情况下你在浏览器里看到的应该直接是D:/JupyterProjects目录下的文件列表。还有一个更快的验证方式在 Jupyter 界面里新建一个笔记本执行以下代码import os print(os.getcwd())输出结果应该就是你设定的默认文件夹说明配置已经生效。2.3 配置优先级为什么改了却像没改修改配置文件后没生效通常不是文件内容写错而是启动方式绕过了这个配置文件。你需要知道一条规则命令行的显式参数优先级高于配置文件。也就是说如果你在启动时用--notebook-dir指定了目录那么配置文件里的设置会被覆盖。另外新版 JupyterLab 还会读取jupyter_server_config.py和jupyterlab_server_config.py如果你在多个文件里都设置了根目录不同文件里的配置可能互相冲突。我的建议是不要到处分散设置统一修改jupyter_notebook_config.py中的ServerApp和NotebookApp两项就足够了其他配置文件保持默认避免后续排查时搞不清楚是谁覆盖了谁。考虑到不同版本配置项的兼容性差异如果你不确定当前版本支持哪个参数可以在终端执行jupyter lab --show-config这个命令会列出当前生效的配置参数如果看到root_dir或notebook_dir后面跟着你设置的路径说明配置已经被正确加载。3. 不想永久改配置三种临时切换方案更灵活3.1 命令行参数启动有时候你只是想临时用一下某个目录不想改动任何配置文件。这时候最简单的方式是在启动命令里直接指定路径例如jupyter notebook --notebook-dir D:/JupyterProjects新版 JupyterLab 同样支持这个参数jupyter lab --notebook-dir D:/JupyterProjects如果你的目标路径包含空格比如D:/My Documents/Notebooks一定要用引号把路径包起来jupyter notebook --notebook-dir D:/My Documents/Notebooks这种方法适合临时处理某个项目的场景。我平时会在项目目录下放一个start.bat文件内容就是上面这行命令双击就能在当前项目目录启动 Jupyter不用记路径也不会影响其他项目。不过要注意这个方案只在当前窗口生效关掉终端再启动就恢复默认了。3.2 快捷方式参数与初始位置设置如果你习惯从开始菜单或桌面快捷方式启动又不想修改全局配置文件Windows 下有个更“隐藏”的操作右键快捷方式进入属性在“目标”一栏的结尾加上启动参数。原本目标可能是这样C:\ProgramData\Anaconda3\python.exe C:\ProgramData\Anaconda3\cwp.py C:\ProgramData\Anaconda3 C:\ProgramData\Anaconda3\python.exe C:\ProgramData\Anaconda3\Scripts\jupyter-notebook-script.py你可以在最后加上--notebook-dirD:/JupyterProjects同时在“起始位置”一栏填上目标文件夹这样即使用参数没有生效程序启动时也会尝试进入起始位置指向的目录。这个方法的好处是不需要记住命令行坏处是每个快捷方式只能固定一个目录想切换多个项目目录就得建多个快捷方式。3.3 Anaconda Navigator 和 VS Code 场景下的路径处理不少人其实已经不用网页版 Jupyter 了而是直接在 VS Code 里写.ipynb文件。这种情况下“默认文件夹”的概念发生了改变VS Code 里 Jupyter 插件打开文件时使用的当前工作目录取决于你 VS Code 打开的文件夹而不是 Jupyter 的配置文件。所以如果你希望在 VS Code 里新建的笔记本默认落到某个目录最简单的方式是直接把那个目录作为 VS Code 的工作区打开。至于 Anaconda Navigator它的界面里点击 Jupyter 按钮虽然也能启动但老实说我不太推荐通过它来调整目录因为它封装了太多层不容易确认最终传给 Jupyter 的参数。更好的做法是从 Anaconda Prompt 或 CMD 手动启动参数透明可控。如果你确实习惯 Navigator 的图形界面可以在启动 Jupyter 之前先修改配置文件再回到 Navigator 点 Launch效果和命令行启动一致。4. 改完不生效常见问题与排查手册4.1 配置文件改了却没生效的四种可能第一个可能你修改的文件根本没被读取。Jupyter 搜索配置文件的路径和你的预期可能不一样尤其是通过 pip 和 conda 各装过一次 Jupyter 的情况下。用jupyter --paths命令可以查看当前环境实际使用的配置目录确认你修改的文件是否在这个目录列表里。第二个可能启动入口对冲。如果你在开始菜单里点的是 Anaconda Navigator 创建的快捷方式它走的可能是 Anaconda 自带的启动脚本跟你手动执行jupyter notebook不是同一条路径。所以排查的时候要统一启动方式建议优先从命令行启动进行验证。第三个可能配置项名称写错。老版本教程里常用c.NotebookApp.notebook_dir新版本里某些发行版已经改为推荐c.ServerApp.root_dir但两者并不是在所有版本都互相兼容。为了避免这个问题我建议两个配置项同时写上这样无论内部走哪个逻辑都能兜底。第四个可能浏览器和内核缓存。有些人改完配置后直接刷新浏览器页面发现还是老路径就以为配置没生效。实际上 Jupyter 在启动时读取配置修改后必须重启服务进程最好把终端窗口里正在运行的 Jupyter 进程彻底关掉重新执行启动命令。有时候 JupyterLab 的浏览器端也会缓存部分 UI 状态可以强制刷新一次页面。4.2 高频报错速查表结合最近搜索趋势里出现的一些典型问题我整理了一张速查表这里面的问题我都实际遇到或帮别人排查过现象常见原因处理办法启动 Jupyter 报ImportError: DLL load failed while importing rpds相关底层库rpds-py和当前 Python 版本不匹配或者缺少必要的 VC 运行库优先升级 rpds-pypip install --upgrade rpds-py如果无效则安装最新的 Microsoft Visual C Redistributable再不行就重装 Jupyter 相关组件单元格执行代码后没有任何反应内核连接失败、内核崩溃或 Notebook 的 kernel 状态异常打开 Kernel 菜单选择 Restart Kernel如果持续无反应在终端里启动 Jupyter 查看报错日志重点检查 python 环境变量与内核是否匹配浏览器地址变成.../tree?tokenxxx但页面打不开端口被占用或防火墙拦截换端口启动jupyter notebook --port8889或检查防火墙是否允许 Jupyter 连接本地端口输入jupyter提示“不是内部或外部命令”Jupyter 脚本目录没有加入 PATH优先使用python -m jupyter notebook启动或者在 Anaconda Prompt 中再执行一次初始化操作代码自动补全不生效新版 JupyterLab 需要额外安装补全插件或内核没有正确响应请求确认使用 JupyterLab 时已安装 jupyterlab-lsp或者退回 Notebook 界面测试是否正常打开 Jupyter 后文件列表空白默认文件夹指向了一个不存在或无权限访问的路径检查配置中的目录是否存在路径是否包含中文字符或特殊符号必要时临时改回默认目录测试这张表里最容易被忽略的是第一个 DLL 问题。很多人以为是配置文件写错了结果排查半天发现是底层库崩溃。遇到这种情况我先建议升级 rpds-py这个包负责处理部分数据解析逻辑版本不稳定时容易出现导入即报错的问题升级之后大部分场景都能恢复正常。4.3 定位问题的通用排查技巧如果你改了配置、重启了服务问题依旧存在我的通用排查顺序是先确认启动入口再确认配置加载最后确认目录权限。确认启动入口的方法是退出所有 Jupyter 窗口打开一个新的终端执行where jupyterWindows或which jupyterLinux/macOS看看命令指向哪里。如果同一个终端里执行jupyter --paths看到的配置目录和你修改的文件不在同一个层级那问题基本就定位到了。确认配置加载的方法是执行jupyter lab --show-config或jupyter notebook --show-config把输出结果中的root_dir字段找出来看看是不是你设置的路径。如果显示的还是默认路径说明配置文件没有被读取这时候检查文件位置和文件名注意 Jupyter 要求配置文件名必须包含对应的 app 名称不能随便命名成my_config.py然后指望它生效。最后是目录权限问题。如果你设置的路径是一个新建的空文件夹或者放在系统保护目录下Jupyter 可能因为权限不足而回退到默认目录。解决办法是先把目录权限调整为当前用户可以读写或者换一个自己创建的路径比如D:/JupyterProjects这个路径看起来简单实际上能避免很多权限和编码方面的坑。5. 从默认文件夹延伸出去的日常习惯5.1 按“项目目录”组织笔记本而不是按“年份”设置默认文件夹这件事表面上只是改一个路径实际上影响的是日常使用 Jupyter 的习惯。我见过不少人把默认目录设为C:\Users\自己的名字然后所有.ipynb文件都零散地放在用户目录下时间一长文件多到根本找不到。与其这样不如借这个机会好好规划一下目录结构。我的个人习惯是在某个盘符下建一个统一的 Jupyter 根目录比如D:/JupyterProjects在这个根目录下再按项目划分子文件夹例如D:/JupyterProjects/data_analysis、D:/JupyterProjects/leetcode、D:/JupyterProjects/experiments。Jupyter 默认打开根目录后我可以在文件列表里直接看到所有项目不需要额外导航。这个习惯尤其适合日常“随手写一段代码验证想法”的场景比每次都从头导航到层层嵌套的目录要高效得多。5.2 配置备份与多环境同步的小技巧配置文件修改完以后我建议你顺手复制一份备份或者把它纳入自己的配置同步体系。这个文件本身很小但它包含了你的默认目录、启动参数和很多常用设置。一旦重装系统或者更换工作电脑有了这份配置文件能省下重新摸索的时间。另外如果你像我一样经常在多台电脑之间切换有一个细节值得注意不同电脑的目录结构往往不一致配置文件中不要写死一个绝对路径可以考虑写一个通用目录比如D:/Projects然后每台电脑都按照这个约定建立目录。如果某个环境下目录确实不同就用命令行参数临时覆盖这样比每台机器修改一次配置更灵活。最后再提醒一句修改配置文件后尽量用python -m jupyter notebook的方式来启动这能保证你使用的 Jupyter 一定来自当前 Python 环境避免启动入口混乱带来的各种莫名问题。