讲师中心 微信公众号
AI工具推荐 视频效率加速

Jupyter Notebook出现闪退窗口怎么办

阿杰大大_7196

阿杰大大_7196

发布时间:2026-08-31 09:49:58

|

493人浏览过

|

来源于php中文网

原创

双击快捷方式闪退主因是启动路径错误、工作目录不存在或markupsafe版本不兼容;应将快捷方式目标改为jupyter-notebook.exe,设置有效起始位置,执行jupyter notebook --debug定位报错,降级markupsafe至2.0.1,并生成及配置jupyter_notebook_config.py指定合法notebook_dir。

jupyter notebook出现闪退窗口怎么办

双击快捷方式后黑窗闪退,基本不是 Jupyter 本身坏了,而是启动路径、工作目录或依赖版本出了问题。

检查快捷方式目标是否指向 jupyter-notebook.exe

很多闪退源于快捷方式“目标”字段错误地指向了已丢失或损坏的 jupyter-notebook-script.py。Windows 上新版 Anaconda(尤其 24.6+)默认不再生成该脚本,但旧快捷方式仍保留引用。

  • 右键开始菜单里的 Jupyter Notebook 快捷方式 → 属性 → 查看“目标”栏
  • 如果内容类似 "D:Anaconda3python.exe" "D:Anaconda3Scriptsjupyter-notebook-script.py",这就是问题根源
  • 应改为直接调用 jupyter-notebook.exe:"D:Anaconda3Scriptsjupyter-notebook.exe"(路径按你实际安装位置调整)
  • 同时把“起始位置”设为一个真实存在的空文件夹,比如 D:jupyter-work,避免因默认路径不存在而崩溃

运行 jupyter notebook --debug 看真实报错

不靠猜,直接在终端里跑带调试参数的命令,能立刻暴露底层错误。常见两类输出:

Jupyter Notebook 7.5.4
Jupyter Notebook 7.5.4

Jupyter Notebook 7.5.4 官方 PyPI wheel 包下载,适合用于本地交互式代码运行、数据分析、教学演示和配置文件实践。

下载
  • 报 ImportError: cannot import name 'soft_unicode' from 'markupsafe':说明 markupsafe 版本太高(≥2.1.0),Jinja2 和 notebook 7.x 不兼容
  • 报 FileNotFoundError: [Errno 2] No such file or directory: 'C:\xxx\notebooks':说明配置里指定的 c.NotebookApp.notebook_dir 路径不存在或权限不足
  • 只要看到具体错误行,就不用试一堆玄学方案——它已经告诉你该修什么了

修复 markupsafe 兼容性问题

这是近期最频繁的闪退诱因,尤其在升级过 pip 或手动装过 nbextensions 后。不是重装 Jupyter,而是降级一个依赖:

  • 在 Anaconda Prompt 或普通终端中执行:pip install --force-reinstall markupsafe==2.0.1
  • 别用 pip install markupsafe -U,升级反而会触发问题
  • 如果用 conda 环境,也可:conda install markupsafe=2.0.1,效果一致
  • 执行完无需重启系统,直接再试 jupyter notebook 就能验证

确认并生成 jupyter_notebook_config.py 配置文件

闪退常因 notebook 启动时找不到合法工作目录,而配置文件缺失会让它尝试访问无效路径(比如已删除的旧项目文件夹)。

  • 先运行:jupyter notebook --generate-config,它会在 ~/.jupyter/ 下生成 jupyter_notebook_config.py
  • 用记事本打开该文件,搜索 notebook_dir
  • 取消注释并填入一个**已存在**的路径:c.NotebookApp.notebook_dir = 'D:/jupyter-work'(注意用正斜杠或双反斜杠,单反斜杠会报语法错误)
  • 保存后,该路径就成为 notebook 的根目录;后续双击快捷方式或命令行启动都会以此为准

真正卡住人的地方,往往不是“不知道怎么修”,而是没意识到:闪退窗口一闪而过,不代表没留线索;jupyter-notebook.exe 和 jupyter-notebook-script.py 是两个不同东西;markupsafe==2.0.1 这个版本号必须严格匹配,写成 2.0 或 2.0.2 都不行。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1651

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4044

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1649

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

23417

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2867

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2907

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1143

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

40

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn