VSCode重命名失效主因是语言服务未启动或文件未被识别为对应语言上下文，需检查右下角语言模式是否正确（如JavaScript/TypeScript而非Plain Text），并确保项目根目录存在jsconfig.json或tsconfig.json配置文件。
VSCode 重命名功能为什么有时不生效
重命名（Shift+F2 或右键 → Rename Symbol）失效，通常不是 VSCode 坏了，而是语言服务没启动或当前文件未被识别为对应语言上下文。比如打开一个无后缀的配置文件，或 .js 文件顶部没写 "use strict" 且未配置 jsconfig.json，TypeScript 语言服务就不会激活变量引用分析，rename 就只能改光标处文本，不会跳转修改其他位置。
检查方法：看右下角状态栏是否显示正确的语言模式（如 JavaScript、TypeScript），以及是否出现 Starting JavaScript language features... 类提示。若显示 Plain Text，先点击切换语言模式，再试重命名。
重命名 TypeScript/JavaScript 变量的实际效果差异
TypeScript 因有类型系统和完整 AST 分析，rename 能精准定位所有引用，包括跨文件导出导入、类成员、解构赋值中的同名绑定；而纯 JavaScript 依赖 jsconfig.json 或 tsconfig.json 配置才能实现跨文件重命名。没有配置时，它只改当前文件内“看起来像引用”的标识符——比如 const foo = 1; console.log(foo); 会改，但 obj.foo 或字符串 "foo" 不会动，这是设计使然，不是 bug。
- 确保项目根目录有
jsconfig.json（JS 项目）或tsconfig.json（TS 项目），哪怕内容只是{"compilerOptions": {"allowJs": true}} - 避免在
node_modules或dist目录中触发重命名——这些路径默认被语言服务忽略 -
import { x } from './a'中的x可被重命名，但仅限于该 import 语句内的绑定名；源文件里的原始导出名需去源文件重命名
遇到 “No result” 提示或只改了局部变量怎么办
这说明语言服务认为其他位置不是该符号的“引用”，常见于以下情况：
- 变量是函数参数，但在调用处被硬编码传入字面量（如
fn("oldName")），此时"oldName"是字符串，不是符号引用 - 使用了动态属性访问：
obj[variableName]不会被识别为引用，重命名不会修改variableName的值，也不会改obj上的 key - 变量被
eval()、new Function()或模板字符串拼接使用，这类运行时行为无法静态分析 - 存在同名但不同作用域的变量（如外层
let a和内层const a），重命名只会作用于当前光标所在作用域的声明
此时别硬刚重命名，改用 Ctrl+H（替换）配合 Match Case 和 Match Whole Word 更可靠——尤其当变量名本身有区分度（如带下划线前缀 _internalCount）时。
批量改名后编译报错或运行时异常怎么快速定位
重命名本身不保证逻辑正确性。最常踩的坑是：改了变量名，但忘了同步更新与之强耦合的字符串字面量（如 API 字段名、CSS class 名、JSON Schema key）或正则匹配模式。
- 搜索整个工作区：
Ctrl+Shift+F输入旧变量名，勾选Match Whole Word，人工确认每处是否真该改 - 特别注意
package.json中的scripts、webpack.config.js里的插件配置、.env文件等非源码位置 - 如果变量名出现在 JSDoc 注释里（如
@param {string} oldName），重命名默认不处理注释，需手动更新，否则类型提示会错乱
真正难的从来不是“怎么批量改”，而是“哪些地方不该批量改”——多花十秒看一眼搜索结果，比跑三遍测试还省时间。
