f2重命名失效时应检查语言服务是否就绪：状态栏须显示正确语言模式（非plain text）、项目根目录存在tsconfig.json/jsconfig.json、光标位于可识别符号上、f12能跳转定义，且文件在语言服务作用域内。
Refactor 重命名失效时该检查什么
按 F2 没反应，或只改了当前文件——不是插件坏了，是语言服务没接上。VSCode 的重命名不是文本替换，它靠 TypeScript 或 JavaScript 语言服务器（LSP）做语义分析。
- 右下角状态栏必须显示
TypeScript或JavaScript，不能是Plain Text；点一下就能手动切换 - 项目根目录得有
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容只是{"compilerOptions": {}} - 光标放在变量/函数名上按
F12，能跳转到定义，F2才大概率成功；跳不到，说明 LSP 没索引到导出关系或路径别名没配好 - 确保没在
node_modules、dist或未纳入工作区的子目录里操作——这些路径默认被语言服务忽略
Search and Replace 怎么避免误替
当 Refactor 不可用（比如改的是字符串里的类名、JSON key、JSX 标签名），就得用 Ctrl+Shift+H（Win/Linux）或 Cmd+Shift+H（Mac）。关键不是“能不能换”，而是“换得准不准”。
- 务必勾选
Match Case和Whole Word，否则UserManager会把SuperUserManager也卷进去 - 想精准匹配
new UserManager()但避开注释里的// UserManager is deprecated，开正则模式，写\bnew\s+UserManager\s*\(\) - 路径过滤很关键：在
files to include栏填src/**/*.js或**/*.tsx，排除node_modules和构建产物 - 先用
Ctrl+Shift+F全局搜一遍旧名——VSCode 默认只显示前 1000 条，超量会被截断，这点极易漏看
多文件批量改名（非代码内符号）
资源管理器里多选一堆 .js 文件，按 F2 是无效的。VSCode 明确不支持这种交互，它会报 Cannot rename multiple resources at once 或直接把所有文件改成同一个名字。
- 真要批量改文件名，终端命令最稳：
for f in *.old.js; do mv "$f" "${f%.old.js}.new.ts"; done（macOS/Linux） - Windows 用户用 PowerShell：
Get-ChildItem *.old.js | ForEach-Object { Rename-Item $_.FullName $_.Name.Replace('.old.js', '.new.ts') } - 配色主题文件更特殊：文件名必须和 JSON 里
"id"字段完全一致，改完需重启 VSCode；Windows 用户还得注意大小写是否敏感
重命名后出现 “Some references were not updated” 怎么办
这不是错误，是语言服务在告诉你：静态分析有盲区。它已经尽力了，但有些引用它没法追踪。
- 动态属性访问：
obj[variableName]中的variableName值不会被更新，obj上的 key 更不会动 - 运行时拼接：
eval、new Function、模板字符串里拼出来的调用，LSP 看不见 -
import * as xxx这种模糊导入，重命名源文件里的导出名后，xxx.xxx不会自动同步 - React JSX 中的
<usermanager></usermanager>或 Vue 的<user-manager></user-manager>属于字符串字面量，Refactor 不管，但Ctrl+Shift+H会搜到——得人工判断要不要动
看到提示别急着关窗口，先看底部状态栏显示的 Changed X references，再结合 Ctrl+Shift+F 手动扫一遍字符串、模板、配置项和注释里有没有漏网之鱼。
