PyCharm2021专业版运行Jupyter Notebook无响应问题求助

问题概述 #

PyCharm 2021专业版内运行Jupyter Notebook时，执行单元格后右侧窗口无输出，一直显示“Starting Jupyter Server”，多次尝试无效。但网页版Jupyter可正常运行，说明Jupyter本身功能正常。

已执行的安装操作 #

• 在PyCharm终端运行pip install jupyter notebook，当前Jupyter为最新版本，Notebook版本7.2.1
• 终端执行jupyter notebook可自动跳转网页版，但存在异常：
  • 页面显示登录密码输入框，但点击“Log in”无需输入密码即可进入
  • 终端输出的启动链接不含token，与常规带token的链接不符
• 网页版测试验证正常，可输出“hello world”及计算结果2

已尝试的无效解决操作 #

• 配置Jupyter Server URL时，PyCharm提示“Jupyter Server URL is malformed”
• 手动在链接后拼接/?token=，运行单元格抛出错误：

  Unexpected character ('<' (code 60)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false'......)
  未拼接token时无报错，但仍无响应

• 检查配置文件：jupyter_notebook_config.py中有"## DEPRECATED in 2.0. Use PasswordIdentityProvider.hashed_password # Default: '' # c.ServerApp.password = ''"的标注，jupyter_server_config.json中无密码配置

可行解决方案 #

1. 降级Notebook版本解决兼容性问题 #

Notebook 7.x基于Jupyter Server重构，而PyCharm 2021专业版发布时间较早，对该版本支持存在兼容性问题。将Notebook降级到6.x稳定版：

pip install notebook==6.5.6 --force-reinstall

降级完成后重启PyCharm，重新运行Jupyter单元格。

2. 正确配置带token的Jupyter Server（适配6.x版本） #

• 终端执行jupyter notebook --generate-config生成配置文件
• 运行jupyter notebook password设置登录密码（系统会自动生成哈希值写入配置）
• 启动Jupyter后，终端会输出带token的完整链接，直接复制该链接到PyCharm的Jupyter Server配置中，无需手动修改

3. 对齐PyCharm解释器与终端环境 #

确保PyCharm使用的Python解释器和安装Jupyter的终端环境一致：

• 打开File > Settings > Project: [项目名] > Python Interpreter
• 对比解释器路径与终端中which python（Linux/macOS）或where python（Windows）的输出，不一致则切换到对应解释器

4. 重置PyCharm缓存 #

• 关闭PyCharm，删除缓存目录：
  • Windows：C:\Users\[你的用户名]\.PyCharm2021.2\system
  • Linux/macOS：~/.PyCharm2021.2/system
• 重启PyCharm后重新配置Jupyter

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