Vue DevTools离线安装有三种方法：1.从GitHub Releases或官网下载编译好的chrome扩展包，用开发者模式加载shell-chrome目录；2.从源码中提取packages/shell-chrome文件夹直接使用；3.若需定制，可下载源码后自行构建。
Ctrl+/ 是 VSCode 默认的行级注释快捷键，但“自动生成注释”不是开箱即用的功能——它依赖插件、语言服务和正确配置。Vue 项目中尤其容易因语法解析不全或插件冲突导致注释生成失败或格式错乱。
Vue 文件里 /** 回车不生成函数注释？检查 Vetur 和 JS/TS 语言模式
在 .vue 文件的 <script> 区域写 /** 后按 Enter，若没弹出 JSDoc 模板，大概率是当前编辑器未识别为 JavaScript 或 TypeScript：
- 确认右下角状态栏显示的是 JavaScript 或 TypeScript，不是 Vue（VSCode 原生不支持 Vue 语言模式的 JSDoc 补全）
- 若显示 Vue，点击切换为 JavaScript 或 TypeScript
- Vetur 插件已停更，对 Vue 3 + TS 的 JSDoc 支持有限；推荐改用 Volar（Vue 官方推荐）并启用 Typescript Server 模式
- 在 settings.json 中确认有："javascript.suggest.autoImports": true 和 "typescript.suggest.autoImports": true
离线安装 Vue 相关插件（如 Volar、ESLint、Prettier）的实操要点
离线安装本质是下载 .vsix 文件后手动安装，但 Vue 插件链存在隐式依赖，不能只装一个：
- 必须成套下载：
Volar（含 volar-server）
TypeScript Vue Plugin (Volar)（提供 <script setup> 类型推导）
ESLint（注意：离线安装后仍需本地项目有 eslint 和 eslint-plugin-vue 依赖）
- .vsix 文件名带版本号，例如 volar-1.12.0.vsix，不同 VSCode 版本可能不兼容（VSCode 1.85+ 推荐 Volar ≥1.11）
- 安装顺序有影响：先装 Volar，重启 VSCode，再装配套插件；否则 TypeScript Vue Plugin 可能灰显不可用
- 离线环境下，npm install 无法执行，需提前在联网机器上运行 npm pack eslint-plugin-vue 打包依赖，复制 .tgz 到目标机，再用 npm install ../path/to/eslint-plugin-vue-9.23.0.tgz
vue 项目注释生成插件推荐与避坑点
真正能稳定触发函数/组件注释的插件不多，且多数对 <script setup> 支持滞后：
- Document This：已归档，不兼容 Vue 3 单文件组件的 script setup 语法
- ES7 React/Redux/GraphQL/React-Native snippets：名字带 React，但其 fn、fun 片段在 Vue 的 TS script 中仍可用，输入 fun + Tab 可生成带 /** */ 的函数骨架
- 更可靠的做法是用 Volar 自带的“快速修复”：光标放在函数名上，按 Ctrl+.，选择 Add JSDoc comment（此功能在 Volar 1.10+ 中默认启用）
- 注意：若项目根目录无 tsconfig.json 或 jsconfig.json，Volar 的类型服务会降级，JSDoc 补全直接失效
为什么离线更新后 .vue 文件仍报红、注释不生效？
离线更新插件只是替换前端逻辑，Vue 项目的语义校验实际由语言服务器（如 Volar Server）承担，而该服务是 Node.js 进程，依赖本地 node_modules 中的包：
- 报错信息如 Cannot find module 'vue/compiler-sfc'，说明 @volar/vue-language-service 启动失败，需检查项目中是否已安装对应版本的 vue 和 @vue/language-core
- 注释模板不渲染，常见于 vetur 和 volar 共存：卸载 Vetur 并重启 VSCode（Volar 官方明确要求禁用 Vetur）
- 修改 settings.json 后未生效？确认没有工作区设置覆盖了用户设置，检查右下角齿轮图标 → Open Settings (JSON) 是否打开了正确的配置层级
Volar 的注释补全能力高度绑定项目级 TypeScript 配置和 node_modules 状态，离线环境里最容易被忽略的是：你以为装好了插件，其实语言服务器根本没跑起来。
