闪退大概率不是jupyter本身坏了,而是工作路径没设对、快捷方式指向错误或markupsafe版本冲突;先别重装,90%能5分钟内修好。

直接说结论:闪退大概率不是 Jupyter 本身坏了,而是工作路径没设对、快捷方式指向错误、或 markupsafe 版本冲突这三类问题之一。先别重装,90% 能 5 分钟内修好。
为什么双击快捷方式就闪退,但命令行运行 jupyter notebook 能打开?
这是最典型的快捷方式配置错误。Windows 下 Anaconda 自带的「Jupyter Notebook」快捷方式,目标(Target)里常混着 %USERPROFILE% 或残留的旧路径,起始位置(Start in)又为空或指向不存在的目录——jupyter-notebook.exe 启动时找不到默认工作区,直接退出,黑窗一闪而过。
- 右键快捷方式 → 「属性」→ 检查「目标」字段,确保它最终指向类似
D:\Anaconda3\Scripts\jupyter-notebook.exe的真实路径,**不要带引号外的空格或多余参数** - 「起始位置」必须填一个**已存在的、有读写权限的文件夹路径**,比如
D:\my_jupyter(注意:这个文件夹得提前手动建好) - 改完点「确定」,再双击试试。如果还闪退,把「目标」里的内容复制出来,粘贴到 CMD 里手动执行,看报什么错
ImportError: cannot import name 'soft_unicode' from 'markupsafe' 怎么办?
这是 2023 年后高频闪退错误,根本原因是 markupsafe 升级到了 2.1+,但老版本 jinja2 或 nbextensions 插件仍依赖已移除的 soft_unicode。不是代码写错了,是包不兼容。
- 在 Anaconda Prompt 或 CMD 中执行:
pip install --force-reinstall markupsafe==2.0.1 - 如果用 conda 管理环境,优先试:
conda install markupsafe=2.0.1 - 装完别重启电脑,直接命令行跑
jupyter notebook验证;若仍报错,再顺手升级jinja2:pip install --upgrade jinja2
怎么让每次启动都进固定目录,而不是闪退或跳到 C:\?
靠快捷方式起始位置只能临时解决,真正稳定的方式是改配置文件,强制指定 notebook_dir。否则只要某次在别的路径下启动过,下次双击就可能因路径不存在而闪退。
- 先生成配置:
jupyter notebook --generate-config,记住输出的路径(通常是C:\Users\XXX\.jupyter\jupyter_notebook_config.py) - 用记事本打开该文件,搜索
notebook_dir,去掉行首#,改成你想要的绝对路径,例如:c.NotebookApp.notebook_dir = 'D://my_project//'(注意双斜杠//,单斜杠/在 Windows 下可能被误解析) - 保存前确认
D://my_project//这个文件夹**已经存在**且你有权限访问,否则 Jupyter 启动时会静默失败
真正麻烦的点往往藏在细节里:路径末尾多了一个空格、斜杠方向写反、配置文件改了但没保存、或者 notebook_dir 指向的是一个符号链接而非真实目录。遇到反复闪退,第一反应不该是重装,而是打开 CMD 手动执行 jupyter notebook --debug,看第一行报错——那才是真实病因。











