重命名变量无反应，需确认语言模式正确、光标位于可识别符号上、项目配置支持语义分析（如tsconfig.json/jsconfig.json），否则仅作文本替换或失效。
重命名变量时没反应？检查是否在支持的语言模式下
VS Code 的重命名功能不是全局生效的，它依赖当前文件的语言模式（Language Mode）是否启用了语义重命名。比如打开一个 .txt 文件或未识别后缀的文件，F2 或右键「重命名符号」会直接失效，连提示都没有。
- 确保右下角状态栏显示的是正确的语言（如
JavaScript、TypeScript、Python、Go），而不是Plain Text - 如果是
.js但显示为JavaScript React，一般不影响；但如果是JSON或Markdown模式，重命名一定不可用 - TypeScript 和 JavaScript 项目需有基础类型支持（比如存在
tsconfig.json或jsconfig.json），否则可能只做简单文本替换，不识别作用域
按 F2 没变化？确认光标落在可重命名的标识符上
重命名只对「符号（symbol）」有效，不是所有单词都能改。常见失败场景：
- 光标停在字符串里：
console.log("user_name")中的user_name是字符串字面量，不会被识别为变量名 - 停在注释中：
// const user_name = ...—— 注释内容不参与语义分析 - 变量未被声明或来自外部库（无类型定义），某些语言服务（如 Python 的 Pylance）可能跳过未解析的引用
- 使用了动态属性访问：
obj[<code>key] 中的key变量名无法被静态推导，重命名不会修改该处
改了名字，但部分引用没更新？看是不是跨文件或作用域问题
重命名是否“全量同步”，取决于语言服务的能力和项目配置：
- TypeScript 默认支持跨文件重命名（只要模块能被正确解析），但若
tsconfig.json中"composite": true且未启用"references"，可能漏掉依赖项目中的引用 - JavaScript 项目必须有
jsconfig.json，否则仅做当前文件内简单匹配（类似查找替换） - Python（Pylance）对
from xxx import y的重命名支持较好，但对import xxx后用xxx.y访问的情况，通常不会重命名y—— 因为它属于xxx模块内部 - Vue / Svelte 单文件组件中，
<script></script>区域重命名正常，但模板区的{{ user_name }}是否更新，取决于插件是否开启模板语义支持（如 Volar 对 Vue 3 是默认开启的）
想强制全文本替换？别急着关语言服务
直接用 Ctrl+H（Cmd+H）全局替换看似快，但风险很高：
- 会误改字符串、注释、其他变量的子串（比如把
username改成accountName，结果username_input变成accountName_input，而你其实想保留原意） - 绕过类型检查，可能破坏解构赋值、函数参数顺序等隐式契约
- 不触发 ESLint / Prettier 自动修复，容易引入格式或规则问题
更稳妥的做法是：
- 先确保语言模式和配置就位，再用
F2 - 如果仍有遗漏，配合
Ctrl+Shift+O（转到符号）确认该变量是否被语言服务真正识别 - 对极少数顽固引用（如模板字符串拼接、
eval相关），再手动核对
重命名看着是个小操作，但背后依赖语言服务的完整性和项目配置的合理性。很多人卡住，其实不是 VS Code 不行，而是当前文件根本没被当成“可分析的代码”对待。
