双击jupyter notebook快捷方式闪退的根源是目标路径中引用了已移除的jupyter-notebook-script.py文件;修复方法是将快捷方式“目标”改为直接指向jupyter-notebook.exe,并同步修改“起始位置”为scripts目录。

直接双击快捷方式就闪退,不是没装好,也不是缺 Python —— Anaconda 自带 jupyter-notebook.exe,但默认快捷方式依赖一个已不存在的脚本文件 jupyter-notebook-script.py,这是 Win10/Win11 上最常见、最典型的闪退根源。
为什么双击快捷方式就黑框一闪而过
Windows 开始菜单里的「Jupyter Notebook」快捷方式,目标路径通常是类似这样的命令:
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 "%USERPROFILE%/"
问题就出在最后那个 jupyter-notebook-script.py:它在较新版本的 Anaconda(尤其是 2023 年后打包的)中已被移除,但快捷方式没同步更新。系统找不到这个文件,进程立即退出,黑框就关了。
- 不用重装 Anaconda,也不用怀疑安装失败
-
jupyter-notebook.exe本身是完好的,就在Scripts目录下 - 命令行里运行
jupyter notebook能成功?说明核心环境没问题,只是快捷方式坏了
快速修复快捷方式目标路径
右键开始菜单中的「Jupyter Notebook」→「更多」→「打开文件所在的位置」→ 右键快捷方式 →「属性」→ 修改「目标」栏为以下任一形式(推荐第一种):
-
"C:\path\to\Anaconda3\Scripts\jupyter-notebook.exe"(最简,直接指向可执行文件) -
"C:\path\to\Anaconda3\Scripts\jupyter-notebook.exe" --notebook-dir="D:\my_jupyter"(顺手指定工作目录)
⚠️ 注意:起始位置 栏也要改成 C:\path\to\Anaconda3\Scripts,否则可能因路径解析失败再次闪退。
改完点「应用」→「确定」,再双击试试。90% 的闪退问题到这一步就解决了。
其他高频原因与对应处理
如果改完快捷方式仍闪退,优先排查这几个真实存在的干扰项:
-
PermissionError: [Errno 13] Permission denied: 'C:\Users\XXX\AppData\Roaming\jupyter\runtime\...'→ 删除整个%USERPROFILE%\AppData\Roaming\jupyter\runtime文件夹,重启即可 -
ImportError: cannot import name 'soft_unicode' from 'markupsafe'→ 运行pip install markupsafe==2.0.1(新版markupsafe与旧版jinja2不兼容) - 命令行输入
jupyter notebook报ModuleNotFoundError: No module named 'pyzmq'→ 先pip uninstall pyzmq,再pip install pyzmq
这些都不是“玄学问题”,而是具体模块缺失或版本错配,报什么错就修什么包,别跳步骤。
真正该留意的细节
很多人修完快捷方式就以为万事大吉,但容易忽略两点:
- 修改后的快捷方式只对当前用户生效;如果用其他账户登录,得重复操作一次
- 升级 Anaconda 或重装后,快捷方式会还原成旧配置,
jupyter-notebook-script.py依然不会回来 —— 所以建议把修复步骤记成一条批处理命令,或者干脆习惯用anaconda-prompt启动











