F2重命名只改当前文件的根本原因是语言服务未识别跨文件引用，常见于缺失tsconfig.json/jsconfig.json、Pylance未启用、Java扩展未加载或文件被排除在工作区外；需用Shift+F12验证引用范围并检查开发者工具中的textDocument/rename请求。
F2 重命名符号能同步更新所有引用，但前提是语言服务已激活且项目配置正确——否则只是文本替换，漏改或误改很常见。
为什么 F2 重命名有时只改了当前文件？
VSCode 的 rename 功能依赖语言服务器（LSP）做语义分析，不是全文搜索。如果它没识别出跨文件引用，说明：
- 项目缺少
tsconfig.json（TypeScript/JavaScript）或jsconfig.json，导致无法推断模块关系 - Python 文件没装
Pylance扩展，或没启用python.languageServer配置 - Java 项目未安装
Extension Pack for Java，或.project/pom.xml未被正确加载 - 文件被排除在工作区之外（检查
.vscode/settings.json中的files.exclude或search.exclude）
如何确认重命名是否真能跨文件生效？
别等改完才发现漏了——触发重命名前先验证作用域范围：
- 把光标停在目标符号（如
fetchUserData）上，按Shift+F12查看所有引用，如果只显示当前文件，说明 LSP 没解析到其他位置 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，重命名时观察是否有textDocument/rename请求发出及响应 - 对 TypeScript 项目，确保
tsconfig.json中包含"include": ["**/*.ts"]，且没用"exclude"错误屏蔽源码目录
重命名后 import 路径没更新？这是两个独立操作
改函数名 ≠ 改文件名。VSCode 不会自动同步文件系统重命名和符号重命名：
- 先用
F2重命名导出的符号（如export class ApiClient→NewApiClient），所有import { ApiClient }会被自动更新 - 再右键文件 → “重命名”，输入新文件名（如
NewApiClient.ts），此时 VSCode 会弹出提示“是否更新导入路径”，点“是”才改import语句中的路径 - 如果跳过第一步直接改文件名，旧类名还在代码里，import 路径变了但内部符号没变，编译报错或运行时 undefined
最常被忽略的一点：重命名操作依赖项目根目录下有效的语言配置。哪怕只差一个 tsconfig.json 文件，F2 就退化成危险的字符串替换——尤其在 monorepo 多包结构中，每个子包都得有自己的配置入口。
