F2重命名未更新跨文件引用，根本原因是语言服务未识别符号，最直接判断依据是状态栏未显示“1 definition, 5 references”；常见原因包括状态栏显示Plain Text、缺失tsconfig.json/jsconfig.json、光标位置不当或Pylance未启用。
重命名符号时没更新跨文件引用，先看状态栏
VSCode 重命名功能是否生效，最直接的判断依据是右下角状态栏是否显示类似 1 definition, 5 references 的提示。没有这行字，说明语言服务未识别该符号为可重构目标，F2 按下后只会做文本替换，而非语义更新。
常见原因包括：
- 文件未被语言服务接管：右下角显示
Plain Text而非TypeScript、JavaScript或Python - 项目根目录缺少
tsconfig.json（TS）或jsconfig.json（JS），导致无法解析模块导入导出链 - Python 文件未启用 Pylance（检查设置中
python.languageServer是否为Pylance） - 光标停在字符串、注释、JSX 属性值或点号右侧（如
obj.user的user部分），这些位置不触发符号重命名
jsconfig.json / tsconfig.json 必须包含哪些配置
仅创建空文件不够，关键配置缺失会导致引用链断裂。以 JS 项目为例，jsconfig.json 至少需包含：
{
"compilerOptions": {
"allowSyntheticDefaultImports": true,
"moduleResolution": "node",
"target": "ES2020",
"checkJs": true,
"maxNodeModuleJsDepth": 2
},
"include": ["**/*.js", "**/*.jsx"],
"exclude": ["node_modules"]
}
TS 项目同理，tsconfig.json 中 include 和 compilerOptions.moduleResolution 是跨文件重命名的硬性依赖。改完配置后务必执行命令面板中的 Developer: Restart TS Server（TS）或 Developer: Restart Extension Host（通用）。
F2 重命名后 import 路径没变？检查文件系统重命名流程
符号名和文件名是两件事：F2 只改代码中所有对该符号的引用（包括 import 语句里的名字），但不会自动改文件名；反之，右键文件 → “重命名” 只改路径，不改内部类/函数名。
正确顺序必须是：
- 先在源文件中把光标放在导出符号上（如
export class MyService），按F2改成NewService→ 所有import { MyService }自动变成import { NewService } - 再在资源管理器中右键该文件 → “重命名”，改为
NewService.ts→ VSCode 弹出“是否更新导入路径？”提示，点“是”才会同步修正import语句里的路径（如从./MyService改为./NewService）
跳过第一步直接改文件名，import 路径会更新，但内部类名仍为旧名，编译或运行时立刻报错。
哪些引用永远无法被 F2 自动更新
语言服务只处理静态可分析的引用。以下情况 F2 完全不识别，也不报错，必须人工检查：
- 动态属性访问：
obj["user" + "Name"]、obj[key]（key是变量） - TypeScript 中
any类型对象上的任意属性：const x: any = {}; x.userName - JSX 属性名：
<UserForm userName="x" />（除非组件类型定义了userNameprop） - Python 中
from module import *导入的符号（Pylance 默认不追踪） - 字符串拼接的 require/import 路径：
require("./" + name + ".js")
重构前扫一遍这类模式，比上线后排查 undefined 更省力。它们不是配置问题，而是语义分析的天然边界。
