F2 重命名失效主因是语言服务未正常工作，需配置 jsconfig.json/tsconfig.json、避免 any 类型、显式导出函数，并警惕字符串、动态属性等语义盲区。
为什么 F2 重命名有时不生效，甚至改错地方
VSCode 的 F2 不是简单地全局替换文本，而是基于语言服务（Language Server）做语义识别。如果当前文件没被正确解析（比如缺少 jsconfig.json 或tsconfig.json），或者类型信息缺失（如未声明类型、用了 any），F2 就只能退化成“局部字符串替换”，导致漏改、多改、跨作用域误改。
- 确保项目根目录有有效的
jsconfig.json（JS）或tsconfig.json（TS），否则F2在 JS 文件里大概率只作用于当前文件 - TS 中避免过度使用
any——它会让语言服务“失明”，F2无法准确判断变量作用域边界 - Vue 单文件组件中，
F2默认不跨<script setup>和<template>，需开启"javascript.preferences.renameShorthandProperties": true（仅 TS/JS 有效，对模板插值无效）
如何让 F2 安全地跨文件重命名函数
跨文件重命名的前提是：目标函数必须能被语言服务“导出并识别”。常见失败场景是函数定义在匿名对象、IIFE 或未导出的模块顶层，此时 F2 根本看不到外部引用。
- 函数必须显式导出：
export function foo() {}或export const foo = () => {}；const foo = () => {}+ 无export→F2不会跳转到其他文件的调用处 - 确保导入路径可解析：如果用的是相对路径
import {foo} from '../utils'，但../utils没导出foo，F2会静默失败（不报错，也不跨文件） - 检查状态栏右下角：看到“TypeScript”或“JavaScript”字样且无警告图标，才代表语言服务正常工作；若显示“Plain Text”，
F2完全不可用
重构前必须检查的三个边界情况
F2的“安全”是相对的，有些代码结构天然不在语义分析范围内，强行重命名等于手动Ctrl+H，风险极高。
- 字符串中的函数名：
eval('foo()')、setTimeout('foo()', 100)、console.log('calling foo')——F2永远不碰这些，必须人工核对 - 动态属性访问：
obj[variableName]或obj['foo']不会被识别为对foo的引用，重命名后可能断掉逻辑 - 正则字面量或模板字符串里的函数名：
/foo()/、`call ${fnName}`—— 同样逃逸于语义分析，F2视而不见
替代方案：什么时候该放弃 F2，改用其他方式
当 F2 灰掉、无响应，或你发现它只改了部分引用时，别硬等——说明语言服务已放弃推断。这时候换策略更省时间。
- 用
Shift+Ctrl+H（Windows/Linux）或Shift+Cmd+H（Mac）打开全局搜索替换，但务必勾选“Match Case”和“Whole Word”，避免误伤foobar这类子串 - 对 TS 项目，运行
tsc --noEmit --watch观察编译错误：重命名后如果出现Cannot find name 'xxx'，说明漏改，比肉眼扫快得多 - Git 暂存变更前，执行
git diff | grep -E '^+' | grep -v 'import|export'快速筛查非导入 / 导出行的新增内容，确认是否混入意外修改
真正麻烦的从来不是怎么按 F2，而是判断此刻该不该按——语言服务看不见的地方，它不会提醒你，只会沉默地留个坑。
