VSCode的F2重命名功能依赖语言服务器（LSP）支持，若LSP未加载或配置错误（如缺少tsconfig.json、Pylance未启用、gopls异常、.vue文件无Volar等），则退化为简单文本替换；使用前须确认语言模式正确、LSP无报错、F12能准确定义跳转。
VSCode 自带的重命名功能（F2）在绝大多数场景下足够安全、可靠，无需额外安装插件；但它的“安全”有前提——依赖语言服务器（LSP）支持，且项目需正确配置。
为什么 F2 有时不起作用或只改了局部？
这不是 VSCode 本身的问题，而是底层语言服务没加载成功或能力不全：
-
JavaScript/TypeScript：默认启用完整重命名，但若项目无tsconfig.json或jsconfig.json，可能只做简单文本替换 -
Python：需安装并启用Pylance（推荐）或Pyright；python.defaultInterpreterPath配置错误会导致符号解析失败 -
Go：必须开启"go.useLanguageServer": true，且gopls进程运行正常 - 自定义文件类型（如
.vue、.astro）：需对应插件提供 LSP 支持，否则F2退化为纯字符串替换
哪些插件真能增强重构能力？
真正值得加的只有两类：补足 LSP 缺失环节的，或解决跨文件/跨语言边界问题的：
-
ES7+ React/Redux/React-Native snippets：不参与重命名，但减少手动改名需求 -
Vetur（Vue 2）或Volar（Vue 3）：提供.vue单文件组件内的语义化重命名 -
Rename Tag：专用于同步修改 HTML/XML 标签名及其闭合标签，和变量无关但常被误当作“重构工具” -
Refactorix（已停更）、JS Refactor（仅限旧版 JS）：基本被现代 LSP 覆盖，不建议新增依赖
重命名前必须检查的三件事
跳过任一环节，都可能引发静默失败（比如漏改某处引用却无报错）：
- 确认当前文件右下角语言模式正确（如显示
TypeScript React而非Plain Text） - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 是否有LSP连接错误或no definition found类警告 - 对关键变量，先用
F12（转到定义）测试能否准确定位——无法跳转，F2必然不可靠
最易被忽略的是作用域判断：VSCode 的重命名默认只影响当前作用域可见范围（比如函数内声明的 let x 不会改同名的全局 var x），但它不会主动提示你“还有另一个同名变量在别处”。需要你自己心里有数，或借助 Ctrl+Shift+O 全局符号搜索验证。
