VSCode重命名失效因缺乏语义支持，需启用TypeScript/Pylance等语言服务并配置正确路径与导出方式。
重命名函数时引用没跟着变？检查插件是否启用语义重命名
VSCode 默认的 rename 功能（F2）只在基础文本层面工作，遇到同名变量、跨文件未导入、或类型定义不明确时，常漏改引用。真正可靠的重命名依赖 TypeScript 语言服务或 Python 的 Pylance 等语义分析能力——不是装了插件就行，得确认它正在提供语义支持。
- 打开命令面板（Ctrl+Shift+P），输入
Developer: Toggle Developer Tools，切换到 Console 标签页，重命名后看是否有Failed to find definition类错误 - TypeScript 项目必须有
tsconfig.json，且文件在include范围内；否则rename退化为纯字符串替换 - Python 用户需确认已安装
Pylance（非仅 Python 插件），并在设置中启用"python.languageServer": "Pylance"
跨文件重命名失败？先验证路径解析和模块导入是否完整
函数在 A.py 定义，B.py 用 from A import func 引用——此时重命名 func，B.py 中的调用能改；但若用 import A 再写 A.func()，VSCode 默认不追踪这种点号链式引用，除非项目配置了正确的模块解析逻辑。
- TypeScript：检查
tsconfig.json中的"baseUrl"和"paths"是否与实际 import 路径匹配，否则rename无法定位别名导入 - Python：确保
pyrightconfig.json或pyproject.toml中设置了include覆盖所有源码目录，否则子包里的引用会被忽略 - JavaScript：ESM 项目需有
jsconfig.json，CommonJS 项目建议补全"type": "module"声明，否则require()引用可能不被识别
重命名后出现类型错误或运行时报 undefined？注意别名和导出方式差异
重命名本身成功，但代码跑不起来，大概率是导出/导入方式与重命名机制不兼容。VSCode 的语义重命名会修改 export 名，但不会自动同步更新 default 导入、解构导入或动态 require 字符串。
- 避免对
export default function foo()重命名——rename会改函数名，但import xxx from './x'中的xxx不变，导致运行时取值为undefined - 慎用
export { foo as bar }这类重命名导出，VSCode 不会反向更新import { bar }中的bar - 动态引用如
module[<code>'foo'] 或eval('foo()')永远不会被重命名捕获，需人工排查
想批量重命名多个函数？别依赖插件自动推导，手动加限定条件
VSCode 没有“选中多个函数一起重命名”的原生功能。所谓批量，本质是多次触发 rename，但每次都要小心作用域污染——比如重命名 handleClick，结果把组件里所有同名事件处理器都改了，而其中某些本应保留原名。
- 先用
Ctrl+F搜索函数定义位置（如function handleClick或const handleClick =），确认是否唯一 - 重命名前，将光标停在函数名上，按
F2，输入新名字后立刻看右下角预览窗口：它列出的所有引用是否都在预期范围内 - 如果预览里混入了不该动的引用（比如测试文件里 mock 的同名函数），说明当前项目类型定义太宽泛，需在
tsconfig.json中增加"exclude": ["test/**"]
重命名不是原子操作，尤其涉及导出名、类型声明、JSDoc @param 里的函数名时，VSCode 不会自动同步这些地方。每次改完，建议 grep 全局搜旧名，再扫一眼结果里有没有漏网之鱼。
