离线环境下VSCode需手动安装Volar及Volar for TypeScript插件，并同步node_modules中匹配版本的@vue/language-core，否则Rename Symbol等功能失效；必须在有网机器上触发language server下载并拷贝完整扩展目录，仅装vsix无法启用类型推导和重命名。
离线环境下给 VSCode 加 Vue 支持，核心不是“装上就行”，而是必须让 Volar 完整接管 .vue 文件并加载语言服务；代码逻辑校验本身不离线可用，必须提前在有网机器上触发下载、缓存 language server 和类型定义，否则状态栏卡在 “Downloading…” 就是假安装。
为什么拖 .vsix 进 VSCode 没反应
常见于三种真实场景：
- VSCode 启动后没打开任何文件夹或文件——必须先打开一个空文件夹（
File → Open Folder），否则拖拽区域不激活 - 右下角状态栏显示
Extensions disabled by policy——这是企业组策略禁用扩展，GUI 和code --install-extension都会静默失败，需联系管理员 - 窗口焦点不在 VSCode 上，或系统缩放 >125% + 多显示器导致拖拽坐标偏移——换用命令行方式更可靠
Volar 离线安装后 template 里 ref 类型不识别
这不是插件没装好，而是 Volar 的 language server（如 volar-server）没拉下来。它和插件本体是分离的，首次启用 .vue 文件时才会尝试下载，离线环境直接卡住。
- 必须在有网机器上：打开一个
.vue文件 → 等状态栏右下角出现绿色Vue (Volar)标识 → 再去拷整个扩展目录（如~/.vscode/extensions/vuejs-language-tools.volar-1.12.0） - 不能只拷
.vsix文件——解压后目录里含node_modules下的二进制 server 和预编译的 TS 类型包 - ARM Mac 要确认目录名含
darwin-arm64，x64 机器则要win32-x64或linux-x64，混用会报Cannot find module
ESLint 报错但保存不自动修复
离线环境里，eslint.config.js 配置生效的前提是 ESLint 插件能定位到项目根目录下的配置文件，且未被 files.associations 错误覆盖。
- 检查
settings.json是否有"files.associations": { "*.vue": "html" }——这会让 ESLint 完全忽略.vue文件，应删掉或改为"*.vue": "vue" -
editor.codeActionsOnSave必须显式开启："source.fixAll.eslint": true，仅靠formatOnSave不会触发 ESLint 修复 - 确保项目里有
eslint.config.js（ESLint v8.22+ 推荐格式），内容至少包含files: ['**/*.vue']和languageOptions.parserOptions.parser: '@typescript-eslint/parser'
逻辑错误检测在离线时为何几乎失效
VSCode 本身不分析逻辑，所有“潜在空指针”“未覆盖分支”类提示都来自外部语言服务器（如 tsserver、pyright、mypy），它们依赖远程获取的类型库、规则集或项目级语义图。
- TS 项目开启
"strict": true后，tsserver才会报告Object is possibly 'null'，但前提是node_modules/typescript已存在且版本匹配 - Python 用
pyright替代pylint才可能捕获类型流矛盾，但pyright的 stubs（如stdlib类型定义）默认从 npm registry 下载，离线需提前运行pyright --createstub并拷全量stubs/目录 - 没有一种离线方案能让 ESLint 自动发现 “if A then B，但没处理 !A 场景”——这类业务逻辑必须靠单元测试或契约断言（
assert/invariant）补位
真正难的不是装插件，是让每个依赖环节（language server、type stubs、CLI 工具、schema registry）都在离线前完成初始化并验证可运行。拷目录比拷 .vsix 多花 2 分钟，但能省掉 3 小时排查 “为什么没提示”。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
