VSCode 中可使用 autoDocstring、Python Docstring Generator、Pylance 或自定义快捷键生成 Python 文档字符串：1. 安装 autoDocstring 后输入 ””” 并回车；2. 安装 Python Docstring Generator 后用 Cmd+Shift+P 调用命令；3. 配合 Pylance 类型标注自动补全；4. 绑定 shift+alt+d 快捷键调用生成命令。
如果您在使用 VSCode 编写 Python 代码时希望快速为函数或类生成符合规范的文档字符串，则可能是由于缺少合适的扩展配置或未正确触发生成机制。以下是实现此功能的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 autoDocstring 扩展
autoDocstring 是 VSCode 中最广泛使用的 Python 文档字符串生成 工具，支持 Google、NumPy 和 reStructuredText 等多种格式，通过快捷键即可触发生成。
1、打开 VSCode 的扩展面板，点击左侧活动栏中的扩展图标（或按 Cmd+Shift+X）。
立即学习“Python 免费学习笔记（深入）”；
2、在搜索框中输入 autoDocstring，找到作者为 Nils Werner 的扩展。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
4、在 Python 文件中，将光标置于函数定义下方空行处，输入三个双引号 “”” 并按下 Enter 键。
二、使用 Python Docstring Generator 扩展
该扩展专为 Python 设计，提供更精细的字段控制能力，例如自动填充参数类型、返回值类型及异常说明，适用于需要严格类型标注的项目。
1、在扩展市场中搜索 Python Docstring Generator，确认发布者为 yinfei yang。
2、安装后，在设置中搜索 python docstring，进入扩展配置页。
3、将 Python Docstring Generator: Style 设置为 google 或 numpy。
4、在函数体第一行输入 “””，随后按 Cmd+Shift+P 调出命令面板，输入 Generate Docstring 并回车。
三、配置 Pylance + JSDoc 风格注释支持
借助 Pylance 的类型推断能力，可实现基于已有类型提示的智能文档字符串补全，无需额外扩展，适合已启用 type hint 的代码库。
1、确保已安装 Pylance 扩展并设为默认 Python 语言服务器。
2、在 settings.json 中添加配置项：“python.analysis.typeCheckingMode”: “basic”。
3、为函数参数和返回值添加类型标注，例如 def greet(name: str) -> str:。
4、在函数定义后新起一行，输入 “”” 后立即触发自动补全，选择建议的 docstring 模板。
四、手动绑定自定义快捷键调用生成命令
当默认触发方式不响应时，可通过键盘快捷键直接调用文档字符串生成逻辑，提升操作确定性与一致性。
1、按 Cmd+Shift+P 打开命令面板，输入 Preferences: Open Keyboard Shortcuts (JSON)。
2、在右侧用户快捷键文件中插入以下 JSON 条目：
3、将 key 字段设为 shift+alt+d，command 字段设为 autoDocstring.generateDocstring。
4、保存文件后，在任意 Python 函数定义行按设定组合键，即可强制生成文档字符串。
