RStudio使用reticulate包时无法查看Python函数文档的报错问题

问题根因 #

该错误由两个版本的pydoc渲染逻辑不兼容导致：RStudio 1.4帮助面板调用的内部html接口格式，与reticulate 1.20导出的Python文档生成函数参数要求不匹配，触发attempt to apply non-function报错；同时对应的静态帮助html文件未被正确生成，因此帮助面板返回/python/xxx.html not found提示。

解决方案 #

• 方案1：回退reticulate到适配版本
  reticulate 1.18版本可与RStudio 1.4正常适配，运行以下代码安装指定版本：

  install.packages("devtools")
  devtools::install_version("reticulate", version = "1.18")
  

  安装完成后重启RStudio，即可恢复?命令、F1快捷键查看Python文档的功能。

• 方案2：使用替代查看方式
  若不需要调整包版本，可直接调用内置help函数在控制台输出文档：

  # 示例：查看np.random.rand的文档
  reticulate::py_run_string("import numpy as np; help(np.random.rand)")
  

• 方案3：升级RStudio版本
  将RStudio升级到2022.02及以上版本，即可原生兼容reticulate 1.20及后续版本的Python文档渲染逻辑，无需调整包配置。

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