离线环境vscode无法自动修复vue代码，根本原因是volar、eslint-plugin-vue、typescript解析器三者缺一或版本不匹配；必须手动安装匹配的.vsix插件、同步node_modules依赖，并确保状态栏显示vue(volar)、tsconfig.json含src/*/、eslint.validate包含"vue"且双解析器配置正确。
离线环境里 VSCode 根本不会自动修复 Vue 代码问题，不是配置没写对，而是关键语言服务压根没起来——Volar、eslint-plugin-vue、TypeScript 解析器这三样缺一不可，且必须手动配齐版本匹配的 .vsix 和 node_modules 依赖。
离线装 Volar 后 Rename Symbol 仍不工作？检查这三点
Volar 是 Vue 重构能力的底层支撑，离线时它不光要装扩展，还得让 LSP 服务真正跑起来。
- 状态栏右下角必须显示
Vue (Volar)，若显示HTML或空白，说明文件没被识别为 Vue：按Ctrl+Shift+P→ 输入Change Language Mode→ 手动选Vue - 项目根目录必须有
tsconfig.json或jsconfig.json，且"include"至少包含"src/**/*"，否则 Volar 不加载<script setup></script>区域 - 必须同时安装两个独立扩展：
Volar和Volar for TypeScript（不是同一个），后者负责defineProps类型推导和重命名支持；只装前者，F2在setup里会静默失效
ESLint 自动修复在离线 Vue 项目里失效的主因
不是规则没写，而是 ESLint 根本没扫描到 .vue 文件里的 JS/TS 逻辑——解析链断在了第一步。
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
-
eslint.validate必须显式包含"vue"，仅写["javascript", "typescript"]无效 - 项目里必须已安装
eslint-plugin-vue（v9+ 对应 Vue 3），且.eslintrc.js中extends启用了plugin:vue/vue3-essential类配置 -
<script setup></script>需双解析器配合：parserOptions.parser设为"@typescript-eslint/parser"，同时overrides中为"*.vue"单独指定parser: "vue-eslint-parser"，单用 TS parser 会跳过 script 块 - 离线时别指望插件自动下载
pyright或prettier，但 ESLint 本身不依赖远程二进制——只要node_modules/eslint和插件存在即可运行
离线部署插件时最常卡住的三个兼容性环节
拖 .vsix 没反应、提示 not compatible、装完不生效，几乎都出在这三处，顺序错一个就白忙。
- 查本地 VSCode 版本：运行
code --version，取前两位（如1.85.2→1.85）；再用unzip -p xxx.vsix extension/package.json | grep engines看"vscode": "^1.80.0"—— 你本地版本必须 ≥ 这个值 - Windows 路径含空格或中文？
code --install-extension命令中路径必须加英文双引号：code --install-extension "C:\my ext\volar.vsix" - 企业策略禁用扩展？右下角弹
Extensions disabled by policy就得放弃拖拽，改用手动解压：unzip volar.vsix -d volar-unpacked→ 进入%USERPROFILE%\.vscode\extensions\→ 新建文件夹命名为johnsoncodehk.volar-1.15.0（按实际 publisher.name-version）→ 把解压内容全拷进去 → 彻底退出 VSCode（含托盘进程）再启动
离线环境里没有“试错成本低”这回事。Volar 的 Commit ID、eslint-plugin-vue 的大版本号、VSCode 的 engines.vscode 字段——这些不是细节，是开关。漏掉任意一个，F2 和 Ctrl+S 就只是两个普通快捷键。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
