可一键生成规范docstring的方法有三种：一是安装autodocstring扩展，输入"""后回车自动补全；二是配置python docstring generator扩展并设置格式，用cmd+shift+2触发；三是用官方python扩展配合shift+option+d快捷键生成。
如果您在使用 VSCode 编写 Python 函数时，希望快速生成符合主流规范（如 Google、NumPy 或 reStructuredText）的 Docstring，但手动编写耗时且易出错，则可能是由于缺少合适的扩展或未正确配置文档生成器。以下是实现一键生成规范 Docstring 的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 AutoDocstring 扩展
AutoDocstring 是 VSCode 中最广泛使用的 Python Docstring 生成工具，支持多种格式，无需额外配置即可快速触发。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
立即学习“Python免费学习笔记（深入）”；
2、在搜索框中输入 AutoDocstring，找到由 Nils Werner 发布的同名扩展。
3、点击“安装”，安装完成后重启 VSCode 或重新加载窗口。
4、在 Python 文件中，将光标置于函数定义下方的空行处，输入三个双引号 """ 并按下 Enter 键，自动补全对应格式的 Docstring 框架。
二、配置 Python Docstring Generator 扩展
该扩展提供更精细的字段控制与模板自定义能力，适合对文档结构有明确要求的项目。
1、在扩展市场中搜索 Python Docstring Generator，安装由 Nils Werner 维护的版本（注意区分名称相近的其他扩展）。
2、按下 Cmd+,（macOS）打开设置，搜索 docstring format，在下拉菜单中选择 google、numpy 或 restructuredtext。
3、在函数定义后新起一行，输入 """，然后按下 Cmd+Shift+2（默认快捷键），触发完整 Docstring 插入。
三、使用内置 Python 扩展 + JEDI 配合快捷键
VSCode 官方 Python 扩展已集成基础 Docstring 支持，结合语言服务器可实现零扩展依赖的轻量生成。
1、确保已安装 Microsoft 官方 Python 扩展（ID: ms-python.python）。
2、在用户设置 JSON 中添加配置项："python.analysis.extraPaths": ["."]，以保障类型推断准确性。
3、将光标置于函数名上，按下 Shift+Alt+D（Windows/Linux）或 Shift+Option+D（macOS），直接插入基于函数签名推导的 Docstring。
