根本原因是volar语言服务器未启动：右下角未显示vue(volar)、缺少tsconfig.json或include配置、node未安装、未保存就重命名、漏装volar for typescript插件，或node_modules中@volar/vue-language-server缺失。
离线环境里 VSCode 无法自动转换 Vue 写法，根本原因不是功能缺失，而是 Volar 的语言服务器没起来、defineProps 类型未被识别、或重命名操作没触发 LSP 请求——所有“自动转换”都依赖实时类型分析，离线时缺一个环节就卡死。
为什么 Rename Symbol（F2）在 .vue 文件里完全没反应
这不是快捷键失效，是 LSP 服务压根没加载成功：
- 右下角状态栏没显示
Vue (Volar)，而是HTML或空白 → 点击它，手动执行Ctrl+Shift+P > Change Language Mode > Vue - 项目根目录没有
tsconfig.json或jsconfig.json，或其中"include"没包含"src/**/*"→ Volar 不扫描脚本区，defineProps当作普通函数处理 - 离线机器没装
node，或node -v报错 →@vue/language-core启动失败，静默退出，不报错也不提示 - 改了
defineProps类型后直接按 F2 → 必须先Ctrl+S保存，否则 Volar 缓存还是旧类型，重命名只作用于已保存状态
Volar for TypeScript 必须单独装，否则 <script setup> 里 rename 失效</script>
Volar 和 Volar for TypeScript 是两个独立扩展，离线时漏装后者，<script setup> 中的 props、emits 重命名会全部退化为文本替换：</script>
- 在有网机器上打开 VSCode，进扩展市场搜
Volar，记下版本号（如v1.15.0）和 Help > About 里的 Commit ID（如5c3e652d45） - 拼下载地址：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/johnsoncodehk/vsextensions/volar/1.15.0/vspackage?vsVersion=5c3e652d45（Commit ID 替换真实值） - 同理，再搜
Volar for TypeScript，下载对应版本的 .vsix —— 它不是子包，是独立插件，名字不含 “Volar” 前缀 - 两个 .vsix 都要拖进离线 VSCode 主编辑区安装，且都需启用；装完重启窗口，别只重载
离线批量替换 v-bind: → : 要避开模板语法误伤
不能无脑全局搜索替换，v-bind:class、v-bind:style 等合法写法会被连带破坏：
- 打开
Ctrl+Shift+H，搜索框填正则：v-bind:(\w+)=，替换框填：:$1= - “包含文件”设为：
**/*.vue，确保只扫 Vue 单文件组件 - 务必勾选
.*（正则模式），否则(\w+)不生效 - 替换前先
git checkout -b refactor-vue-shorthand→ 离线没法跑npm run test或 E2E 验证，分支是唯一回滚路径 - 逐个点开预览结果，重点检查是否误匹配了注释、字符串字面量或
<style></style>区域内的内容
自动转换失败时，最常被忽略的其实是 node_modules 同步
离线部署不是只拷插件，Volar 启动时会从 node_modules/@volar/vue-language-server 找二进制，这个路径必须存在且可执行：
- 在跳板机（有网）用相同 Node 版本执行：
npm install @volar/vue-language-server - 确认
node_modules/@volar/vue-language-server/bin/vue-language-server.js存在 - 把整个
node_modules目录同步到离线项目根目录，别只拷@volar子目录 - VSCode 内置终端中运行：
npx vue-language-server --version，有输出才说明语言服务器可用
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
