F2重命名依赖语言服务识别语义引用，若状态栏显示“Plain Text”、缺失jsconfig.json/tsconfig.json或光标未落在声明处变量名上，将退化为局部替换或无响应。
F2 重命名不是搜索替换，它只改语义上真正关联的引用；但前提是 VSCode 能“看见”这个变量——否则就退化成改当前词，甚至完全没反应。
为什么按 F2 没反应或只改了当前一处
这不是快捷键失效，而是语言服务压根没接管这个符号。常见断点有三个：
- 右下角状态栏显示
Plain Text或错误语言模式（比如.ts文件被识别为JavaScript React），点击切换成TypeScript或对应语言 - 项目根目录缺少
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容是空对象{}，没有它语言服务通常不启用跨文件分析 - 光标停的位置不对：必须落在声明处的变量名上（如
let userName的userName），不能在字符串里、注释里、obj[variable]的方括号内，也不能只悬停在词中间而未完整选中
如何确认变量已被语言服务识别
最直接的办法是验证跳转能力：
- 把光标停在变量名上，按
Ctrl+Click（macOS 是Cmd+Click）——能跳转到定义，说明符号可定位；跳不到，重命名大概率漏改 - 看底部状态栏是否显示类似
1 definition, 4 references的提示；没显示，说明语言服务未建立引用关系 - 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，在 Console 里搜renameProvider或no definition，常有具体报错
重命名生效范围受哪些配置影响
尤其对 JavaScript/TypeScript 项目，几个关键配置会决定能否跨文件、是否包含解构或导入别名：
-
jsconfig.json或tsconfig.json中的"include"必须覆盖所有源码文件，否则外部引用不被索引 - 若用路径别名（
paths），需同时配"baseUrl": "."，否则语言服务找不到模块真实位置 - 开启
"javascript.preferences.renameShorthandProperties": true和"typescript.preferences.renameShorthandProperties": true，才能重命名对象简写属性（如{ name }中的name） - 动态访问（
obj[variableName]）、eval、with语句里的变量，语言服务无法静态推导，F2 不会选中它们
遇到 “Cannot rename symbol” 怎么办
这个错误不是操作失误，而是语言服务明确拒绝介入。典型场景包括：
- 变量定义在
node_modules或未启用的类型声明文件（.d.ts）中，VSCode 默认禁止修改第三方代码 - 变量来自
import * as utils from 'xxx'，但没启用自动导入补全，语言服务无法绑定别名 - 文件后缀与语言模式不匹配（比如写了 TypeScript 语法却保存为
.js），右下角语言模式要手动切到TypeScript - 使用了
module.exports = { foo }这类 CommonJS 导出，TypeScript 语言服务对混合模块支持弱，重命名可能只限本文件
真正难处理的不是报错本身，而是那些没报错却悄悄漏掉的位置——比如模板字面量中的变量名、JSON 键、或者被 as const 推导后脱离类型链的值。这些地方 F2 根本不会高亮，也无提示，只能靠人工核对或静态扫描辅助。
