F2 批量重命名变量需语言服务器支持语义分析，若文件类型错误、插件未启用、类型缺失或变量未被绑定，则仅改当前处；应检查语言模式、配置自动导入、精确双击选中、确保 tsconfig/jsconfig 覆盖源码。
F2 确实能批量重命名变量，但前提是 VSCode 能准确识别出你选中的“是变量”，不是字符串、注释或 JSON 键——否则它只会改当前光标处，不会跳转到其他引用。
为什么按了 F2 没反应，或者只改了当前行？
VSCode 的重命名依赖语言服务器（Language Server）提供语义分析。如果没开、没装对、或文件类型识别错了，F2 就会退化成纯文本替换。
- 检查右下角状态栏：确认当前文件语言模式正确（比如
JavaScript React不等于JavaScript，某些插件对后者支持更全） - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 里有没有LanguageClient相关报错 - 常见坑：.ts 文件里用了
any或缺少类型声明，TypeScript 语言服务器可能无法推导变量作用域，导致重命名失效
哪些变量名能被安全重命名？
只有被语言服务“绑定”到同一声明的标识符，才会被联动修改。局部变量、函数参数、类成员、导出的 const/let 声明基本都支持；但以下情况大概率失败：
- 未声明直接赋值的全局变量（如直接写
foo = 123） - 通过
eval()、new Function()动态生成的变量名 - 对象字面量中未加引号的键（
{ name: 'x' }中的name是属性名，不是变量） - JSX 属性名（如
<div classname="x"></div>中的className不会被重命名影响）
怎么让 F2 更可靠？关键配置和前置动作
别等出问题才调，提前把基础设对：
- 确保已安装对应语言的官方插件（如
ESLint插件本身不提供重命名能力，但TypeScript and JavaScript Language Features是内置且必须启用的） - 在
settings.json中确认开启："javascript.suggest.autoImports": true和"typescript.suggest.autoImports": true（有助于语言服务建立完整符号图） - 首次重命名前，先用鼠标双击变量名选中它（不是拖选，也不是 Ctrl+单击），再按
F2；VSCode 对“精确选中声明点”很敏感 - 如果项目有
jsconfig.json或tsconfig.json，确保"include"覆盖了所有源码目录，否则语言服务可能“看不见”部分文件
替代方案：当 F2 失效时，用什么补救？
别硬按 F2，先判断是不是语义层问题。如果是，就换策略：
- 用
Ctrl+Shift+H（全局替换），但务必勾选Match Case和Whole Word，避免误改userName里的name - 在 Explorer 面板右键文件夹 →
Find in Folder...，输入变量名 + 正则\b变量名\b（需开启正则模式），人工核对上下文再替换 - 对 TypeScript 项目，临时加类型注解（如
const foo: string = 'x'）再试 F2，常能唤醒语言服务
真正难的不是按键，是让 VSCode 理解你写的到底是不是“一个变量”。很多重命名失败，根源不在快捷键，而在语言服务压根没把那个词当成可绑定的符号。
