F2重命名参数只改当前函数，因其本质是作用域内符号级重构：仅更新该参数在函数声明及内部所有引用，不跨函数、不触碰调用方实参名，这是LSP基于语义分析的设计行为，非bug。
为什么F2重命名参数只改了当前函数？
VSCode 的 F2 默认重命名行为是「符号级」而非「文本级」——它只更新该参数在**当前函数作用域内被声明和使用的全部位置**，不会跨函数、不触碰调用方传入的实参名，更不会改其他函数里同名但无关的参数。这是设计使然，不是 bug。
比如你在 function calculate(a, b) { return a + b; } 中对 a 按 F2，只会改函数签名里的 a 和函数体内所有 a 的访问，而 calculate(x, y) 里的 x 完全不受影响。
- 参数重命名天然受限于作用域边界：语言服务器（LSP）只把参数视为局部绑定，不认为它和调用处变量存在语义关联
- TS/JS 中若参数带类型标注（如
a: number），重命名更稳定；纯 JS 若无 JSDoc，可能连函数体内引用都识别不全 - Python 中参数重命名同样只限本函数，且若参数名与内置名冲突（如
list,id），F2会直接禁用
想改调用处的实参名，得手动或换思路
调用方传入的变量名（如 calculate(userAge, userScore) 中的 userAge）不属于被重命名参数的符号范围，F2 不处理。你有三个实际选择：
- 如果那个变量只在此处使用，先用
Ctrl+K Ctrl+X提取为常量/变量，再对新变量名F2—— 这样改的是变量本身，调用处自然同步 - 如果它已在别处定义（如
const age = 25;），那它的重命名必须回到定义处按F2，否则只改调用点就是文本替换，风险极高 - 真要批量改某变量在所有调用中的出现位置，用
Ctrl+H（勾选Match Whole Word和Match Case），但务必逐个确认，尤其防字符串和注释误伤
哪些参数重命名会意外失效？
即使光标停在参数上，F2 也可能没反应或只做局部文本替换——常见于以下情况：
- 文件未被识别为正确语言：右下角显示
Plain Text或JSON，而非TypeScript/Python，此时 LSP 根本没加载 - TS/JS 项目缺
tsconfig.json或jsconfig.json，LSP 无法建立跨文件语义链接，参数重命名退化为单文件行为 - Python 项目没启用 Pylance（仅装旧版 Python 扩展），或根目录缺少
pyproject.toml，参数无法被索引为可导出符号 - 参数名被包裹在解构中但未完整选中：比如
function({ name })，光标需双击选中整个name，停在括号内或逗号后都会失败
真正安全的参数重构路径
与其强求「一次改透所有相关名字」，不如按语义分层处理：
- 函数参数名代表「输入契约」，应尽量稳定；频繁要改，说明接口设计过细，优先考虑重构函数职责
- 调用处的实参变量名代表「上下文含义」，它属于调用方代码域，修改权应在定义它的作用域内
- 若多个调用都用类似变量（如都传
user.id），可提前抽象一层：提取共用逻辑为新函数，让参数名在新层级统一可控 - 重命名后必看预览窗口——哪怕只显示 2 处修改，也要点开确认是否包含所有预期位置，尤其是箭头函数参数、回调形参等易被忽略的隐式声明点
参数不是孤立字符串，它是作用域、类型系统和调用链共同约束的节点。想靠一个快捷键扫清所有相关名字，本质上是在对抗语言的设计边界。
