VSCode中Google风格Docstring格式化失效问题咨询

Pylance版本迭代确实可能改动Docstring的渲染逻辑，这大概率是你遇到问题的原因，下面是具体的排查和解决步骤：

1. 回退Pylance版本验证 #

打开VSCode扩展面板，找到Pylance，点击右上角齿轮图标选择「Install Another Version...」，选一个之前能正常显示加粗的旧版本（比如2024.3.x及之前的版本），重启VSCode后再测试鼠标悬停效果。如果恢复正常，就实锤是新版本的问题。

2. 检查Pylance核心配置 #

打开VSCode设置（快捷键Ctrl+,），搜索「Pylance Docstring」，确认两项关键配置：

• 确保python.analysis.docstringFormat设置为google
• 检查python.analysis.hover.showDocstring是否处于开启状态（默认是开的，但可能被误关）

3. 修正Docstring格式规范 #

你的示例里Returns部分不符合Google风格规范——Google风格的Returns不需要写参数名，正确格式应该是：

def add(a: int, b: int) -> int:
    '''Add two numbers

    Args:
        a: first number
        b: second number

    Returns:
        The sum of the two input integers
    '''
    c = a + b
    return c

格式错误可能导致Pylance无法正确识别并渲染加粗样式，修正后再测试悬停效果。

4. 排查扩展冲突 #

如果上面的步骤都没用，暂时禁用其他Python相关扩展（比如官方Python扩展、Jupyter等），重启VSCode后测试，看是否是扩展之间的冲突导致渲染异常。

如果回退版本有效，建议去Pylance的官方仓库提交issue，带上你的Docstring示例和版本信息，帮助官方修复这个bug。

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