F2重命名需jsconfig.json才能跨文件生效，否则仅局部替换；失效主因包括文件类型错误、缺少配置、光标位置不当及动态访问等无法静态分析的场景。
F2 重命名在 JS 中能用，但默认只改当前文件；要跨文件生效，必须配 jsconfig.json，否则它只是个“高级查找替换”。
为什么按 F2 没反应，或只改了局部？
VSCode 的 JS 重命名不是靠字符串匹配，而是依赖语言服务解析 AST。常见失效原因：
- 右下角显示
Plain Text或JavaScript React→ 点击切换为JavaScript - 项目根目录没
jsconfig.json→ 跨文件引用链断开，import和export处的变量名不会被识别为同一符号 - 光标停在
obj.name的点号后、引号内、注释里，或变量名中间 → 不触发语义重命名，只弹出“No result” -
const user = { name: 'a' }中想统一改name字段：必须先选中对象字面量里的name:再按 F2，否则只改user.name访问处
JS 项目必须配 jsconfig.json 才能真正跨文件重命名
哪怕最简配置，也要让语言服务知道“这是个 JS 项目”。不配就只能改当前文件内的显式声明和访问（比如 let x = 1; console.log(x);），但 import { x } from './a' 或 export const x = 2 都不会联动。
新建 jsconfig.json，内容至少包含：
{
"compilerOptions": {
"allowJs": true,
"checkJs": false,
"target": "ES2020",
"module": "commonjs"
},
"include": ["**/*.js"],
"exclude": ["node_modules"]
}配完后重启语言服务：命令面板运行 Restart TS Server（JS 项目也走这个）。
函数名重命名要注意调用链是否可推导
JS 没类型系统，重命名函数时能否更新所有调用处，取决于调用是否“静态可分析”：
- ✅
myFunc();、obj.myFunc();、import { myFunc } from './x'; myFunc();→ 可被识别并更新 - ❌
obj['my' + 'Func']();、const key = 'myFunc'; obj[key]();、eval('myFunc()')→ 完全跳过，必须手动改 - ⚠️
fn(myFunc)这种传参调用：重命名myFunc声明时，参数名myFunc在fn内部不会变 —— 因为那是另一个作用域的绑定
如果函数来自 require('./x').myFunc，且没 JSDoc 类型标注，重命名也可能失败；建议补 /** @type {function(): void} */ 提升识别率。
别信“一键全改”，动态访问和字符串拼接永远绕不开
JS 的灵活性决定了重命名有天然盲区。以下情况 VSCode 绝对不处理，必须人工介入：
-
obj[userFieldName]中的userFieldName是变量 → 重命名该变量不会改obj上的 key -
'user_' + id这类拼接出来的属性名 → 不算符号引用，F2 对它完全无感 - JSX 属性如
<user name="x"></user>→ 若没定义User组件的 PropTypes 或 JSDoc，name不被视为可重命名符号 -
import * as utils from './utils'后用utils.xxx→ 重命名xxx声明不会更新这里的调用，因为utils是命名空间导入
真正安全的批量改法是：先用 F2 改语义明确的部分，再用 Ctrl+Shift+H 全局搜索，勾选 Match Case 和 Whole Word，限定文件类型为 **/*.js，对剩余动态场景做精准正则替换。
