f2重命名符号前必须确认三件事：语言模式为ts/js/python等支持lsp的语言；项目根目录存在tsconfig.json或jsconfig.json；目标符号能通过f12跳转到定义。
F2重命名符号前必须确认的三件事
直接按F2改变量名，结果只更新了当前文件——不是VSCode坏了，而是你没满足跨文件重命名的基本前提。它不是文本替换，是依赖语言服务的语义操作。
- 右下角语言模式必须是
TypeScript、JavaScript或Python等，不能是Plain Text；点一下就能手动切换 - 项目根目录得有
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容只是{"compilerOptions": {}} - 目标符号得能被跳转：光标放上去按
F12，如果能跳到定义，F2才大概率成功；跳不到，说明LSP没索引到或导出关系不明确
Ctrl+Shift+L和F2根本不是一回事
Ctrl+Shift+L是纯文本全选，F2是符号重构——混用会漏改或误改。比如把UserManager改成UserAdmin，Ctrl+Shift+L会把SuperUserManager里的子串也一起动，而F2只改真正声明和引用的符号。
-
Ctrl+Shift+L前务必开Match Case和Whole Word（右下角勾选），否则data.user.name和user.name会被当成两个东西 - 改完立刻用
Ctrl+Shift+F全局搜旧名，确认没残留；尤其注意JSX属性、Vuev-model、JSON key 这些非代码区域 - 带点号、括号的字符串（如
obj.method()）要用Ctrl+H开正则模式测试\bobj\.method\b是否匹配准确
资源管理器里多选+F2是无效操作
在侧边栏选中10个文件，按F2——要么没反应，要么弹出"Cannot rename multiple resources at once"。这不是快捷键失灵，是VSCode明确不支持这种交互。
-
F2在资源管理器里只对单个选中项生效；多选后按F2，VSCode会尝试把所有文件统一改成同一个名字（比如全变成index.js），不是规则化批量替换 - 真要批量改文件名，用终端命令最稳：
for f in *.old.js; do mv "$f" "${f%.old.js}.new.ts"; done（macOS/Linux）或PowerShell版Get-ChildItem *.old.js | ForEach-Object { Rename-Item $_.FullName $_.Name.Replace('.old.js', '.new.ts') } - 配色主题文件更特殊：文件名必须和JSON里
"id"字段完全一致，改名后需重启VSCode，Windows用户还得注意大小写敏感问题
重命名后出现“No symbol found”或“Some references were not updated”
这类提示不是报错，是语言服务在告诉你：静态分析有盲区。比如obj[variableName]、eval、模板字符串拼接，或者import * as xxx这种模糊导入，LSP没法100%追踪。
- 看到
"Some references were not updated"，别急着关窗口，先看底部状态栏显示的Changed X references in Y files——如果X明显偏小，说明有引用没被识别 - 动态访问的代码（如
this[methodName]）必须人工检查并手动改；eval("user.name")类调用无法被F2覆盖 - 跨包/跨node_modules的符号重命名基本失效，除非你用了
types声明或declare module补全类型
