VSCode本身不支持Python接口文档生成，需依赖外部工具并确保终端命令、解释器路径和docstring格式三者对齐：AutoDocstring仅补全函数文档框架，pdoc生成轻量级HTML文档，Sphinx适合正式项目但配置复杂。
VSCode 本身不带 Python 接口文档生成能力，必须靠外部工具 + 正确配置才能跑起来。直接装插件没用，关键在终端命令、解释器路径和 docstring 格式三者对齐。
AutoDocstring：快速补全函数文档框架
它不生成完整 HTML 文档，只帮你把 def 下面的 """ 自动展开成参数/返回值占位结构，省得手敲格式。
- 必须先装扩展：在 VSCode 扩展市场搜
AutoDocstring（Nils Werner 版），安装后重启 - 光标要放在函数定义正下方的空行，输入
"""再按Enter，才会触发补全 - 默认用 Google 风格；想切 NumPy 或 reStructuredText 格式，进设置搜
autodocstring，改autoDocstring.docstringFormat - 如果没反应，检查文件语言模式是不是
Python（右下角状态栏），不是的话点一下手动切过去
pdoc：轻量级 HTML 文档生成（推荐小型项目）
比 Sphinx 简单，不依赖 conf.py，直接读取 docstring 输出可浏览的 HTML，适合 API 快速预览。
- 终端运行：
pip install pdoc—— 注意：必须用和 VSCode 当前选中解释器一致的pip - 生成文档：
pdoc my_module.py或pdoc my_package，结果默认输出到./html/ - 实时预览：
pdoc my_package --http :8000，然后浏览器打开http://localhost:8000 - 常见失败点：模块路径不对（不能用相对导入写法）、
__init__.py缺失、或 docstring 没写在函数/类定义正上方
Sphinx + reStructuredText：适合正式项目文档
功能强但门槛高，VSCode 插件只是壳，真正干活的是你本地 Python 环境里的 sphinx 和 docutils。
立即学习“Python免费学习笔记（深入）”；
- 必须手动装：
pip install sphinx docutils sphinx_rtd_theme（虚拟环境里装，就用那个环境的pip） - VSCode 必须选对 Python 解释器（左下角点击切换），且文件语言模式设为
reStructuredText - 预览时右键必须选
reStructuredText: Preview with Sphinx，普通Preview只走 docutils，不识别:param:这类指令 - 没有
conf.py和index.rst，Sphinx 预览就是摆设；sphinx-quickstart可一键生成最小骨架
最容易被忽略的是解释器一致性——你用 pip install sphinx 装的包，VSCode 却调用了另一个 Python 解释器，结果预览永远报 ModuleNotFoundError。每次换环境，先确认左下角显示的解释器路径和你终端里 which python（macOS/Linux）或 where python（Windows）是否一致。
