右下角显示Plain Text时F2重命名必然失效，因语言服务未启动；需手动切换正确语言模式，确保tsconfig.json/jsconfig.json存在并重启语言服务器。
右下角语言模式显示 Plain Text 就别想重命名
VS Code 的重命名功能根本不会启动，如果状态栏右下角显示的是 Plain Text 或 Auto Detect。它不看文件后缀，只认你手动选的语言模式。哪怕你在编辑 utils.ts，只要状态栏没切到 TypeScript，F2 就只会做文本替换，连当前文件里的其他引用都可能漏掉。
实操建议：
- 点击右下角语言名称，从列表里选准确类型（如
TypeScript、Python、C++） - 对
.vue文件，<script></script>块需单独切换语言模式，不能依赖整体识别 - 写一行明显报错的代码（如 TS 中
const a: number = 'x';），没红色波浪线？说明语言服务压根没接管
tsconfig.json 或 jsconfig.json 缺失 = 跨文件重命名失效
TypeScript/JavaScript 项目没有 tsconfig.json 或 jsconfig.json，语言服务就无法推导模块边界、导出关系和路径别名。这时 F2 只能在单个文件内改，import 不更新、export 不联动、Find All References 返回空——不是功能坏了，是它“看不见”跨文件连接。
实操建议：
- 在工作区根目录（即你用
File → Open Folder打开的文件夹）新建jsconfig.json，最简内容：{"compilerOptions": {"allowJs": true, "checkJs": true, "module": "nodenext", "target": "es2020"}} - 若用了路径别名（如
@/components），必须加"baseUrl": "."和"paths"配置 - 改完配置后，必须执行
Developer: Restart Language Server，不能只靠重启窗口
Python 重命名失败？Pylance 没跑起来是主因
Python 的重命名依赖 Pylance 提供语义分析，不是默认的 Python 扩展自带能力。如果它没加载，F2 就退化成搜字符串，函数调用链、类方法、甚至同文件内的局部变量引用都可能识别错。
实操建议：
- 卸载所有非
ms-python.python的 Python 相关扩展（尤其停更的tht13.python） - 命令面板运行
Python: Select Interpreter，选一个真实存在的 Python 环境（路径不能为空） - 检查设置中
python.languageServer是否为"Pylance"（不是"Jedi"，也不是留空） - 运行
Python: Restart Language Server后，再Developer: Reload Window，最后删缓存目录（Windows 路径通常为%USERPROFILE%\.vscode\extensions\ms-python.pylance-*）
重命名前必须检查的三个隐藏条件
即使语言服务起来了，重命名仍可能只改局部、漏 import、或跳转失效——问题常卡在这三处，且很难从报错里直接看出。
实操建议：
-
export必须是具名导出（export function foo()），export default后接匿名函数/类，重命名后类型信息易丢失 -
import必须是具名导入（import { foo } from './a'），若用import * as a from './a'再a.foo，重命名不会追踪 - 按
F2前先Ctrl+S保存所有相关文件，否则语言服务读的是旧 AST，预览和实际修改范围会不一致
重命名功能是否生效，不取决于你按了多少次 F2，而取决于语言服务是否真正理解了符号的定义域、导出方式和引用路径——这些细节一旦错位，表现就是“找不到符号”，但根源从来不在编辑器本身。
