VSCode不内置注释生成功能，依赖第三方扩展：Python用Python Docstring Generator（需光标在函数定义下方、输入"""回车），JavaScript/TS用Auto Comment Blocks（快捷键Ctrl+Alt+D）。
VSCode 本身不内置代码注释生成（如文档字符串 docstring）功能，真正起作用的是第三方扩展，最常用且稳定的是 Python Docstring Generator（针对 Python）或 Auto Comment Blocks（通用语言）。是否能“自动生成”，取决于语言、扩展配置和光标位置——不是按个快捷键就万能，得对上路子。
Python 项目中用 Python Docstring Generator 补全函数 docstring
这个扩展默认监听 """ 或 ''' 输入后回车，自动补全 Google/NumPy/ReStructuredText 格式。但前提是：光标必须在函数定义下方、空行或第一行缩进内，且函数签名要完整（参数名、类型提示可选但推荐）。
- 安装扩展后重启 VSCode，确保工作区是 Python 项目（有
pyproject.toml或__init__.py） - 写好函数头，比如：
def calculate_total(price: float, tax_rate: float = 0.08) -> float:
- 在函数体第一行输入
"""并回车，它会立刻生成带参数、返回值、说明占位符的 docstring - 如果没反应，检查设置：
python.docstringGenerator.style是否设为google等合法值；确认当前文件语言模式是Python（右下角状态栏）
JavaScript/TypeScript 中用 Auto Comment Blocks 快速插入函数注释模板
它不分析函数签名，而是靠快捷键触发预设模板，适合需要统一风格但不想装重扩展的场景。关键点在于模板变量是否被正确识别——比如 ${functionName} 只在光标位于 function 或 const xxx = 后才生效。
- 安装后默认绑定快捷键
Ctrl+Alt+D（Windows/Linux）或Cmd+Alt+D（macOS） - 把光标放在函数名正前方或函数声明行任意位置，再按快捷键
- 若生成的注释里参数为空，大概率是函数用了箭头函数且没写参数名（如
const fn = () => {}），此时需手动补全或改用具名函数 - 可自定义模板：在设置里搜
auto-comment-blocks.templates，修改javascript对应项，比如加入@param {string} [opt]占位符
为什么有时候按了没反应？常见断点排查
不是扩展坏了，多数是上下文没对上。VSCode 的注释生成高度依赖语言服务和光标语义位置，和普通文本补全逻辑完全不同。
- 当前文件没被识别为对应语言：检查右下角语言模式，点击切换成
Python/TypeScript等，而不是Plain Text - Python 扩展未激活：确认已安装
ms-python.python，且没有禁用；终端里运行python -m pydoc不报错 - 函数体内已有非空内容：部分扩展只在「空白函数体」触发，如果已有
pass或return，先删掉再试 - 多扩展冲突：禁用其他注释类扩展（如
Document This），只留一个主力工具测试
真正麻烦的不是怎么按快捷键，而是 docstring 要和类型提示、实际逻辑保持同步——生成只是起点，后续维护才是常态。别指望一次生成永远有效。
