如何在VS Code中让Google/Sphinx风格Python类属性注释显示悬浮信息？

• 确认语言服务器与配置
  VS Code的Python语言服务默认使用Pyright，它支持Google风格的行内注释，但需要开启基础类型检查：

  1. 打开VS Code设置（快捷键Ctrl+,），搜索python.analysis.typeCheckingMode
  2. 将其设置为basic或strict（默认off模式下Pyright不会解析这类注释）
     正确的行内注释写法示例：

  class TsCity:
      def __init__(self) -> None:
          self.name: str = ""  #: The city name.
  

• 类体注释替代方案
  如果行内写法仍不生效，可改用类级别的属性注释（同样符合Google风格），这种写法VS Code的识别兼容性更好：

  class TsCity:
      """Class representing a city."""
      
      name: str
      """The city name."""
      
      def __init__(self) -> None:
          self.name = ""
  

• 更新Python插件
  确保VS Code的Microsoft Python插件是最新版本，旧版本可能存在注释解析的兼容性问题。

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