如何用PyCharm远程调试JupyterLab服务器中的Notebook？

核心原因 #

PyCharm的Jupyter调试依赖自身专属的pydev_jupyter_utils包，而你当前使用的Docker容器仅预装了JupyterLab原生调试所需的依赖（如jupyterlab-debugger），未包含PyCharm调试必需的pydev系列组件，因此触发ModuleNotFoundError。

可行解决步骤 #

• 借助JupyterLab前端的终端或Notebook单元格安装匹配版本的依赖：
  在Notebook单元格中运行（或通过JupyterLab终端执行）：

  pip install pydevd-pycharm~=<你的PyCharm对应版本号>
  

  版本匹配规则：PyCharm版本和pydevd-pycharm版本需一一对应，比如PyCharm 2023.2对应pydevd-pycharm~=232.8660.186，你可以在PyCharm的File > Settings > Build, Execution, Deployment > Python Debugger路径下找到对应版本号。
• 安装完成后，若有权限则重启JupyterLab服务；若无权限，断开当前连接后重新通过给定URL进入即可。
• 重新在PyCharm中配置远程Jupyter服务器，尝试调试单元格。

替代调试方案 #

如果无法安装pydevd-pycharm包，直接使用JupyterLab自带的调试功能即可：

• 打开目标Notebook，点击单元格左侧的调试按钮（或通过快捷键/命令面板唤起），该功能已验证可用，可满足断点调试、变量查看等基础需求。

搜索方向参考 #

• PyCharm remote Jupyter ModuleNotFoundError pydev_jupyter_utils
• pydevd-pycharm version match PyCharm
• JupyterLab container PyCharm debug non-root

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