F2是重命名符号的默认快捷键，但需语言服务器（LSP）就绪才生效；若状态栏语言模式错误、缺失tsconfig.json/pyproject.toml、未启用Pylance等扩展，或光标位置不当，则F2仅作局部替换或无响应。
F2 重命名不是文本替换，它依赖语言服务器实时解析 AST；没配好语言服务，按了 F2 就只改当前文件，甚至完全没反应。
为什么 F2 按了没反应，或只改本文件？
根本原因是语言服务器没就绪，不是快捷键坏了。VSCode 的 textDocument/rename 请求发出去后，如果语言服务没启动、崩溃、或压根不支持当前文件类型，就会静默失败。
- 检查状态栏右下角语言标识（如
TypeScript、Python），点击确认是否启用对应服务 - TypeScript/JS 项目必须有
tsconfig.json或jsconfig.json，否则跨文件索引常为空 - Python 必须装
Pylance（仅装 Python 扩展不够），且建议项目根目录有pyproject.toml或__init__.py - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），在 Console 里搜rename或failed，常能看到具体报错（如No definition found）
哪些引用 VSCode 根本不会重命名？
所有无法静态确定绑定目标的调用，语言服务器一律跳过——这不是 bug，是设计使然。
-
obj[methodNameVar]()或obj["methodName"]()：运行时属性访问，AST 无法推断目标 -
eval("x = 10")或模板字符串中拼接的变量名：`${key}Value`不会被识别为符号引用 - 第三方库未提供类型声明（如缺少
.d.ts文件），import * as utils from "lodash"后的utils.throttle就可能漏掉 - CommonJS 动态
require("./math").add，若无类型声明，add不会被当作可重命名符号
如何让跨项目、带别名的重命名生效？
关键在告诉语言服务器“这些路径实际指向哪”，否则它连导入关系都解析错，更别说重命名了。
- TypeScript/JS：在
tsconfig.json的compilerOptions.paths中配置别名，例如"@utils/*": ["src/utils/*"]，并确保include覆盖所有源码目录 - Python：在设置中配置
python.analysis.extraPaths，把其他项目的src目录加进去 - 多根工作区：用
文件 > 将文件夹添加到工作区把多个项目加入同一窗口，并保存为.code-workspace文件，VSCode 才会统一索引 - Go：确认
gopls已安装且go env GOPATH下的bin/gopls可执行
editor.renameOnType 开启后反而卡顿或误标？
这个配置会让 VSCode 在你输入新名字时实时预览所有修改点，但它极度吃语言服务性能。一旦项目大、依赖多、或服务器响应慢，就容易卡死或标错范围。
- 不是所有语言都稳定支持它，尤其 Python（Pylance）和大型 TS 项目
- 开启后出现高亮错乱、编辑器假死，建议先关掉：
"editor.renameOnType": false - 真正需要预览影响范围时，用
Shift+F12查看引用列表更可靠，它是显式触发、可控的
最常被忽略的一点：重命名前先保存所有文件，再执行 Developer: Reload Window。很多“引用不全”问题，其实只是语言服务缓存了旧的 AST 状态，重启一下就恢复正常了。
