我正在try 在我的Python类中记录实例变量，这样当我将鼠标悬停在它们上面时，它们就会显示在VS代码中.我发现这招很管用:
class TsCity:
def __init__(self) -> None:
self.name: str = ""
"""The city name."""
但这太难看了.理想情况下，我会使用谷歌风格的文档字符串:
self.name: str = "" #: Doc comment *inline* with attribute
但这并不能在VS代码中正确显示.有没有办法让这种类型的文档字符串在VS代码中工作？
这(#: lorem ipsum)是Sphinx/Google样式的属性文档(相对于pep-0224样式(""" lorem ipsum """))
我询问了Python扩展的维护人员，关于是否存在要求Sphinx样式的属性文档的https://github.com/microsoft/pylance-release/issues/1576#issuecomment-1668718385版本的特性请求问题单.其中一位(Rich Chiodo)回答说:
我想不行.但如果它不是标准文档字符串的一部分，我们可能需要大量的Up投票才能添加它.
我认为这意味着--不，在 compose 本文时，还没有办法获得这种样式的属性文档注释的悬停信息--至少不能使用Microsoft的Python扩展(在 compose 本文时最流行的Python扩展).也许有一个扩展添加了对此的支持，但我不知道它是什么.如果你最终为这一功能向Microsoft Python repo发出了一张功能请求问题单，请在此处 comments 链接，如果你无法 comments ，请建议编辑这篇文章，添加一个链接.