F2重命名需语言服务识别符号才安全跨文件更新，否则为危险字符串替换；须确保右下角显示正确语言模式、配置jsconfig.json/tsconfig.json或pyproject.toml、重启TS Server或Extension Host，并验证跳转定义功能。
F2 重命名不是“按了就生效”，它只在语言服务真正识别符号时才安全跨文件更新；否则就是危险的字符串替换，漏改、误改、卡住全是因为这个前提没满足。
为什么 F2 按下没反应或只改当前文件
根本不是快捷键坏了，而是 VSCode 没把光标下的名字当成一个“可重命名的符号”。常见表现包括：
- 右下角状态栏显示
Plain Text或Auto-detect，而不是TypeScript、JavaScript或Python - 光标停在引号内（如
obj["user"]）、点号后（如obj.user的.后）、注释里，或变量名没被完整高亮 - 项目根目录缺少
tsconfig.json（TS）或jsconfig.json（JS），导致跨文件引用链断裂 - 控制台（
Developer: Toggle Developer Tools）报Language client is not ready
验证是否真通：光标放在变量声明上（比如 const userName = "x"），按 Ctrl+Click（Windows/Linux）或 Cmd+Click（macOS），能跳转到定义才算可靠。
F2 跨文件重命名必须做的三件事
别急着按 F2，先确保语言服务已就位：
- 确认文件后缀正确（如
.ts、.py），右下角语言模式显示对应语言，不是Plain Text - JS/TS 项目：根目录加
jsconfig.json或tsconfig.json，至少含{"include": ["**/*"], "exclude": ["node_modules"]} - Python 项目：装
ms-python.python+ 启用Pyright，并有pyproject.toml或setup.py让其索引整个项目 - 配置改完后，运行命令面板里的
Restart TS Server（TS）或Developer: Restart Extension Host（通用） - 重命名前看底部状态栏有没有类似
1 definition, 5 references—— 没这行字，F2 就只是文本替换
哪些地方 F2 根本不会动，必须手动处理
语言服务只分析静态可推导的引用，以下情况它默认跳过，且不提示：
-
obj["user" + "Name"]→ 字符串拼接，键名无法静态推导 -
const key = "userName"; obj[key]→ 属性名来自变量，非字面量 - TypeScript 中
any类型对象上的访问：const x: any = {}; x.userName - JSX 属性名：
<UserCard userName="x"></UserCard>，若组件类型未声明userNameprop，就不算符号引用 - Python 中
from module import *导入的符号 → Pylance 默认不追踪这类动态导入
重构前扫一遍这些模式，比事后调试省十倍力气。
Ctrl+Shift+L 和 F2 完全不是一回事
混用会直接导致 bug：
-
F2是语义重命名：基于 AST，只改真正声明和引用的符号，跳过字符串、注释、子串（如把UserManager改成UserAdmin，SuperUserManager不动） -
Ctrl+Shift+L是纯文本全选：把当前选中内容当模板，在全文所有精确匹配处加光标，不分上下文 -
Ctrl+D是增量匹配：从当前词开始向后找完全相同的独立单词，默认跳过字符串和注释，但第 4 次可能突然卡在resDataList上 - 用
Ctrl+Shift+L前务必勾选右下角的Match Case和Whole Word，否则data.user.name和user.name会被当成两个东西
改完立刻用 Ctrl+Shift+F 全局搜旧名，尤其注意 JSX 属性、Vue v-model、JSON key 这些非代码区域——它们不在 F2 覆盖范围内。
