能否为Jupyter Notebook及nbsphinx生成的Sphinx文档添加类/类型tooltip功能？

一、Jupyter Notebook/Lab 端实现 #

1. 悬停显示变量类型与文档字符串 #

• 直接使用Jupyter Lab：它原生支持编辑模式下悬停变量/类名，自动弹出包含类型、文档字符串的提示框，体验和PyCharm类似。如果还在用经典Jupyter Notebook，建议切换到Jupyter Lab，或者安装jupyter_contrib_nbextensions扩展包启用相关功能，但Lab的原生支持更稳定。
• 无需额外复杂配置，只要你的代码写了规范的文档字符串（docstring），悬停时就能自动提取显示。

2. 点击跳转至定义 #

• Jupyter Lab中按住Ctrl点击代码里的变量、类或函数名，就能直接跳转到其定义位置——如果定义在同一个Notebook里，会定位到对应单元格；如果是第三方库的对象，只要库的源码可访问，Lab会打开对应的源码文件展示定义。

二、nbsphinx + Sphinx 文档端实现 #

1. 悬停显示变量类型与文档字符串 #

• 借助sphinx-hoverxref扩展：先确保Sphinx项目已启用sphinx.ext.autodoc（自动生成API文档）和nbsphinx（渲染Notebook），安装sphinx-hoverxref后，在conf.py的extensions列表里添加它。
• 配置示例：

  extensions = [
      'nbsphinx',
      'sphinx.ext.autodoc',
      'sphinx-hoverxref',
      'sphinx.ext.intersphinx'
  ]
  hoverxref_role_types = {
      'class': 'tooltip',
      'func': 'tooltip',
      'var': 'tooltip'
  }
  

  生成的HTML文档里，鼠标悬停在代码中的类、函数、变量上时，会弹出包含类型和文档字符串的tooltip。

2. 点击跳转至定义 #

• 依赖Sphinx的交叉引用机制：先用autodoc生成所有类、函数的定义文档，在conf.py中配置intersphinx_mapping（涉及第三方库跳转时），或确保Notebook里的代码引用对象已被Sphinx索引。
• 生成的HTML文档中，代码里的类、变量名会自动变成可点击链接，点击后直接跳转到对应的API定义文档页面。启用sphinx.ext.viewcode扩展，还能让用户从定义文档跳转到源码查看。

注意：不管哪种方案，都需要代码带有规范的文档字符串（比如Google、NumPy风格），工具才能正确提取并展示相关信息。

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