Windows10环境下执行jupyter notebook命令后程序无法启动求助

排查方向与解决方案 #

• 确认虚拟环境路径关联
  激活虚拟环境后，执行where python和where jupyter，确保两者都指向虚拟环境内的路径。若jupyter指向全局Python路径，说明虚拟环境内的Jupyter未正确安装，需激活环境后重新执行pip install jupyter jupyterlab nbclassic。

• 强制使用IPv4启动
  部分Windows环境下IPv6配置异常会导致Jupyter进程挂起，可直接指定IPv4地址启动：

  jupyter notebook --ip=127.0.0.1
  

  若有效，可生成配置文件永久生效：

  1. 执行jupyter notebook --generate-config（若卡住，手动在%USERPROFILE%\.jupyter目录创建jupyter_notebook_config.py）
  2. 在配置文件中添加：

     c.NotebookApp.ip = '127.0.0.1'
     

• 清理残留进程并以管理员权限运行
  打开任务管理器，结束所有python.exe、jupyter.exe进程；然后右键终端选择「以管理员身份运行」，重新激活虚拟环境后执行Jupyter命令。普通权限可能无法创建临时文件或监听端口，导致进程无响应。

• 测试干净虚拟环境
  新建一个无依赖的虚拟环境验证问题是否与原环境损坏有关：

  python -m venv clean_env
  .\clean_env\Scripts\activate
  pip install jupyter
  jupyter notebook
  

  若新环境可正常启动，说明原虚拟环境存在损坏，建议迁移依赖后弃用原环境。

• 排查安全软件拦截
  临时关闭Windows Defender防火墙和第三方安全软件，再尝试启动Jupyter。若恢复正常，需将虚拟环境内的python.exe和jupyter.exe添加到防火墙允许列表。

内容的提问来源于stack exchange，提问作者Andrea Neri