离线环境Vue项目代码补全失效，核心原因是Volar未真正接管.vue文件：需手动同步@vue/language-core、确保tsconfig.json含"types":["vue"]和"include":["src/*/.vue"]、右下角显示“Vue (Volar)”、文件已保存，且@volar/vue-language-server和typescript等底层依赖必须完整离线部署。
离线环境里 Vue 项目代码补全失效，不是插件没装，而是 Volar 没接管 .vue 文件、TS 语言服务没加载、或关键依赖（如 @vue/language-core）根本不存在——装完插件不等于功能就通了。
为什么装了 Volar 还没有 defineProps 补全
核心问题：Volar 的类型推导和符号跳转严重依赖本地 @vue/language-core 包，离线时它不会自动进 node_modules，必须手动同步。
- 在有网机器上执行
npm install -D @vue/language-core，然后把整个node_modules/@vue/language-core目录拷到离线项目的node_modules/下 - 检查项目根目录的
tsconfig.json是否含"types": ["vue"]和"include": ["src/**/*.vue"]，缺一不可 - 打开
.vue文件后，看右下角状态栏是否显示Vue (Volar)；若显示Vue (Vetur)或空白，按Ctrl+Shift+P→Change Language Mode→ 手动选Vue -
defineProps补全只在<script setup>区域生效，且必须已保存文件（Ctrl+S），否则 TS 语言服务不重解析
code --install-extension 安装 Volar 却报 “Extension is not compatible”
这不是网络或权限问题，是 VSCode 主版本号与插件要求不匹配，或架构错位（比如 ARM Mac 装了 x64 插件）。
- 运行
code --version，取输出第一段（如1.90.2→ 主版本是1.90） - 解压 .vsix：
unzip -p volar.vsix extension/package.json | grep engines，确认"vscode": "^1.85.0"这类字段覆盖你的主版本 - Help → About 里记下括号内的架构（
arm64/x64），下载的 .vsix 必须带对应标识（例如darwin-arm64） - 别用第三方打包的 .vsix；必须从 Marketplace 页面点
Download Extension获取原始包
离线补全还依赖哪些容易漏掉的底层包
Volar 自身只是入口，真正干活的是它背后调用的二进制和服务——这些在离线环境下全得提前铺好，否则补全就是“有界面、无逻辑”。
立即学习“前端免费学习笔记（深入）”；
-
@volar/vue-language-server：Volar 的核心语言服务器，离线安装必须包含它的可执行文件（通常在node_modules/@volar/vue-language-server/bin/vue-language-server.js） -
typescript：补全精度直接受typescript.tsdk路径影响；务必在工作区设置中指定"typescript.preferences.includePackageJsonAutoImports": "auto"并确认node_modules/typescript存在 -
esbenp.prettier-vscode和dbaeumer.vscode-eslint：路径别名（如@/components）补全由 ESLint 驱动，不是 Volar 自己干的；离线时这两个插件的 .vsix 也得一起装 - 验证方式：打开命令面板 →
Developer: Toggle Developer Tools→ 查 Console 是否有Failed to activate extension或Cannot find module '@vue/language-core'
离线环境下怎么验证补全真能用
别只看有没有下拉菜单——要测真实场景下的响应链是否完整，尤其是跨区域（<script> ↔ <template>）的联动。
- 新建一个
Test.vue，写<script setup> const msg = 'hello' </script>，再在<template>里输入{{ msg }}—— 如果msg不出现在补全列表，说明模板区域未被 Volar 接管 - 改一个
props名称，按F2重命名，看<template>里绑定的v-bind:xxx是否同步更新；若没更新，大概率是files.autoSave没开或tsconfig.json的include没覆盖.vue - 在
.vue文件里敲ref，看是否弹出带Ref<T>类型签名的建议；没弹出？检查typescript.tsdk是否指向项目级node_modules/typescript，而非全局安装的旧版
最常被忽略的一点：所有补全能力都建立在“VSCode 正确识别文件为 Vue SFC”的前提上。右下角语言模式显示 Vue 两个字，不代表它真用了 Volar；必须看到括号里的 (Volar)，且 node_modules/@vue/language-core 和 @volar/vue-language-server 同时存在，才算闭环。
