jupyter notebook 闪退主因是快捷方式路径错误、工作目录配置非法、依赖库冲突或用户名含中文；需修正快捷方式目标为 jupyter-notebook.exe、设置有效 notebook_dir 路径、降级 markupsafe 或重装 pyzmq、改用 anaconda prompt 启动规避中文用户名问题。
闪退是因为快捷方式目标路径错了
双击桌面或开始菜单的 Jupyter Notebook 快捷方式后黑框一闪就关，大概率不是程序崩溃，而是快捷方式指向了不存在或错误的启动脚本。Windows 下 Anaconda 安装的 Jupyter 通常依赖 jupyter-notebook.exe，但旧版快捷方式常指向已丢失的 jupyter-notebook-script.py（尤其升级到 notebook ≥7.0 后该文件被移除）。
解决方法很简单：
- 右键快捷方式 → “属性” → 查看“目标”字段，如果末尾是
jupyter-notebook-script.py，说明已失效 - 把“目标”改成你 Anaconda 安装目录下的
jupyter-notebook.exe，例如：D:\Anaconda3\Scripts\jupyter-notebook.exe - 同时把“起始位置”设为一个**已存在的空文件夹路径**，比如
D:\jupyter（不能是空字符串或不存在的路径）
工作目录没配或路径非法也会闪退
Jupyter 启动时会尝试进入 c.NotebookApp.notebook_dir 指定的目录。如果配置了但路径不存在、含中文、或权限不足，它不会报错，而是直接退出——黑框都来不及停留。
检查和修复步骤：
- 在命令行运行
jupyter notebook --generate-config，生成或定位jupyter_notebook_config.py - 打开该文件，搜索
notebook_dir，去掉行首#，填入**绝对路径**，注意用正斜杠或双反斜杠：c.NotebookApp.notebook_dir = 'D:/jupyter'或c.NotebookApp.notebook_dir = 'D://jupyter' - 确保该路径文件夹已手动创建，且不含空格、中文、特殊符号
依赖库冲突导致 import 失败而闪退
黑框闪退有时伴随报错但太快看不见。在命令行手动运行 jupyter notebook，能捕获真实异常。常见的是 ImportError，比如：
-
cannot import name 'soft_unicode' from 'markupsafe'→ 降级markupsafe到2.0.1：pip install markupsafe==2.0.1 -
DLL load failed: 文件或目录损坏或报错涉及zmq→ 重装pyzmq：pip uninstall pyzmq && pip install pyzmq -
AttributeError: type object IOLoop has no attribute initialized→ 更新核心组件：pip install --upgrade jupyter_core jupyter_client
用户名含中文是隐藏雷区
如果你 Windows 用户名是中文（如“张三”），系统环境变量 %USERPROFILE% 展开后路径含中文，Jupyter 启动时某些底层库（尤其是 C 扩展）会因编码问题静默失败。
验证方式：在命令行运行 echo %USERPROFILE%，若输出含中文，这就是根源。
临时绕过方法：
- 不点快捷方式，改用 Anaconda Prompt 运行
jupyter notebook（Prompt 默认使用英文环境变量） - 或在命令行先执行：
set USERPROFILE=C:\temp_user（需提前建好该目录），再运行jupyter notebook
真正修复需要新建英文用户名账户，但对多数人来说，用 Anaconda Prompt 启动是最省事且稳定的替代方案。
