F2重命名失效主因是语言服务未就绪，需确认文件类型、扩展启用、配置文件存在；作用域限制、符号解析不准、自动重命名干扰及非标准语法均会导致异常。
重命名功能按F2没反应？先确认语言服务是否就绪
VSCode 的 F2 重命名依赖当前文件的语言服务器（Language Server）正常工作。不是所有文件类型都默认支持，也不是打开即用。
- 确保文件后缀名正确（比如
.ts、.js、.py、.rs），且对应语言扩展已安装并启用（如Python、Rust Analyzer、TypeScript and JavaScript Language Features） - 检查右下角状态栏：看到「TypeScript」「Python」等语言标识，且没有黄色警告图标；若显示「Plain Text」，重命名必然失效
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Developer: Toggle Developer Tools，看 Console 是否报错Language client is not ready - 某些项目（尤其老旧 JS 项目）缺少
jsconfig.json或tsconfig.json，会导致 TypeScript 语言服务降级，重命名范围仅限当前文件 —— 补一个空配置可修复
重命名后只改了局部变量？检查作用域和符号解析精度
VSCode 不是靠字符串匹配，而是基于 AST 解析符号引用。但解析结果受项目结构、类型声明、模块导入方式直接影响。
- 在
JavaScript中未启用jsconfig.json，或使用require()动态加载模块时，跨文件引用常无法识别，重命名只作用于当前文件 -
TypeScript项目中，如果某个变量被any类型污染（例如从localStorage读取未标注类型），语言服务可能无法准确追踪其所有用法 - 函数参数名、
catch块中的错误变量、for...of循环的临时变量 —— 这些属于「局部作用域符号」，重命名默认只影响该作用域内，不会波及同名变量 - 想重命名全局函数但只改了调用处？确认它是否被正确导出（
export function foo()）且导入路径无误；否则 VSCode 当作普通标识符处理，不推导跨文件关系
重命名卡顿或漏改？关掉「自动重命名标签」干扰项
VSCode 默认开启 editor.renameOnType（输入时自动触发重命名），但它和手动 F2 是两套逻辑，共存时容易互相抢占、延迟响应甚至跳过部分引用。
- 打开设置（
Ctrl+,），搜索renameOnType，**关闭它** —— 手动F2更稳定、更可控 - 大项目中（尤其含数千个文件的 TS 项目），首次重命名可能需等待几秒，这是语言服务在构建引用图；此时不要连按
F2，否则触发多次请求，UI 卡死 - 如果重命名弹窗出现但列表为空，或只列出 1–2 处，大概率是符号未被正确解析 —— 尝试保存文件（
Ctrl+S）、重启语言服务（命令面板运行Restart TS Server） - HTML/JSX 中重命名组件名失败？确保你点的是 JSX 标签名本身（光标落在
<MyComponent的MyComponent上），而不是属性或子内容；且组件必须是具名导出或变量声明，非内联箭头函数
重命名后代码崩了？警惕非标准语法和宏展开场景
重命名本质是「安全重构」，但 VSCode 不理解业务语义，对非标准写法、宏、模板字符串插值、字符串拼接构造的标识符名完全无感知。
- 像
const key = 'user' + suffix;这种运行时拼接的键名，不会被识别为对变量user的引用 —— 重命名user变量不影响它 - 使用
eval()、Function()、new Function()动态执行代码时，其中的变量名不会参与重命名分析 - Vue 模板中
v-model="userName"、React 中{userName}JSX 插值能被识别，但data-xxx={userName}这类自定义属性里的绑定名，取决于语言扩展支持程度（Vue 官方扩展支持，基础 JS 扩展不支持） - 用 Babel / SWC 插件做了自定义宏（如
@mixin、css\`...\`），里面的标识符名不在语言服务分析范围内，重命名不会触达
重命名看似一键，实际每一步都踩在语言服务的能力边界上。真正麻烦的从来不是按哪个键，而是搞清当前这个符号 —— VSCode 究竟“看得到”还是“假装看得见”。
