PyCharm内置Jupyter无法渲染pythreejs 3D模型问题咨询

问题描述 #

在PyCharm内置Jupyter环境运行以下代码时无任何输出，但相同代码在网页版Jupyter中能成功渲染3D立方体模型：

from pythreejs import * # pythreejs-V:2.4.2
from IPython.display import display
from math import pi
#%%
# Reduce repo churn for examples with embedded state:
from pythreejs._example_helper import use_example_model_ids
use_example_model_ids()
#%%
BoxGeometry(
    width=5,
    height=10,
    depth=15,
    widthSegments=5,
    heightSegments=10,
    
    depthSegments=15)

差异原因 #

• 前端渲染能力差异：网页版Jupyter依托浏览器环境，原生支持WebGL及pythreejs依赖的JavaScript渲染逻辑；PyCharm内置的Jupyter渲染器对WebGL的支持有限，无法解析pythreejs生成的交互式WebGL组件。
• 输出处理机制不同：pythreejs生成的是需要前端JS引擎处理的交互式组件，PyCharm内置notebook未完整实现这类组件的渲染管线，而浏览器版Jupyter可直接调用浏览器JS引擎完成渲染。

解决方法 #

1. 显式调用display函数 #

当前代码仅定义了BoxGeometry对象，未主动将其输出到notebook。修改代码，添加display()调用：

box = BoxGeometry(
    width=5,
    height=10,
    depth=15,
    widthSegments=5,
    heightSegments=10,
    depthSegments=15)
display(box)

2. 切换PyCharm的notebook渲染模式 #

进入PyCharm设置（File > Settings），找到Tools > Jupyter > Rendering，尝试切换渲染器（比如选择"Browser"模式，让PyCharm调用外部浏览器渲染notebook内容）。

3. 更新PyCharm版本 #

旧版本PyCharm对Jupyter交互式组件的支持不完善，升级到最新版可解决部分兼容性问题。

4. 尝试替代可视化库 #

如果上述方法无效，可改用matplotlib 3D绘图或plotly 3D组件，这些库在PyCharm内置Jupyter中的兼容性更好。

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