离线安装代码注释插件需同时满足语言服务就位、版本严格匹配、依赖完整拉取三条件；JavaScript/TS用Volar或TS Server+JSDoc，Python推荐AutoDocstring，Vue需手动切语言模式，且所有.vscode包须校验vscode版本、架构与路径规范。
离线安装代码注释自动生成插件，本质不是“装一个插件就行”，而是要同时满足语言服务就位、版本严格匹配、依赖完整拉取三个条件——缺一不可。只拖一个 .vsix 进去，大概率显示已安装但 /** 回车没反应，或 Ctrl+Alt+D 按下后静默失败。
确认你真正需要的插件类型
不同语言用的不是同一套机制：
-
JavaScript/TypeScript：靠
Volar（Vue）或TypeScript Server+ JSDoc 补全能力，Document This在离线时对解构参数、箭头函数、泛型支持极差，基本不可靠 -
Python：
AutoDocstring是目前唯一实测离线稳定可用的，它不依赖 LSP，纯客户端解析，快捷键Ctrl+Alt+D触发位置必须在def行末或函数体首行（空行/注释不算） -
Vue 单文件：必须切换
<script>区域的语言模式为TypeScript或JavaScript（右下角状态栏点 Vue → 改为 TypeScript），否则 /** 根本不识别
下载和校验 .vsix 文件的硬步骤
别信网页上“最新版”按钮，它常返回不兼容包。必须手动比对三处：
- 运行
code --version，取前两位（如1.90.2→1.90） - 下载后用
unzip -p your-extension.vsix extension/package.json | grep engines查"engines": {"vscode": "^1.90.0"} - Help → About 里看架构（
x64/arm64），Apple Silicon 机器必须下带darwin-arm64标识的包 - Windows 路径含中文或空格会静默失败，务必用纯英文路径，例如
C:/vsix/autodocstring-2.12.0.vsix
装完不生效？八成是缺语言服务或配置错
VSCode 插件安装只是注册，很多功能首次打开文件才触发依赖下载——离线时这步直接卡死：
-
AutoDocstring不依赖 LSP，装完即用；但若生成内容为空，检查函数定义是否含解构（如def foo((a, b)):）或星号表达式（*args没问题，(a, *b)就可能失败） -
Volar类插件需配套TypeScript Vue Plugin (Volar)，且必须先装 Volar、重启 VSCode，再装配套插件，否则后者灰显 -
Prettier插件要求prettier.requireConfig为true（默认值），没.prettierrc.json5就彻底不干活，也不报错——必须提前配好最小配置 - 插件列表显示“已安装”但无效果？关掉所有 VSCode 进程（包括托盘里的），再重试
最易被忽略的一点：离线环境里，**插件能装 ≠ 功能能跑**。比如 Document This 看似装上了，但遇到 const fn = ({ id }: User) => {} 就连 @param 都不生成，这不是 bug，是它根本没能力解析这种 AST 结构。这时候别调参，换 AutoDocstring（Python）或老老实实用 Volar + 手动补全（TS/Vue）。
