Change Signature仅语法补全不保逻辑安全：新增参数填undefined/空字符串致运行时错误，不更新外部引用、模板调用、泛型类型、.d.ts及typeof引用，须人工验证全覆盖。
Change Signature 会补默认值，但业务逻辑可能崩
WebStorm 的 Change Signature（快捷键 Ctrl+Shift+P → 输入 “Change Signature”，或右键 → Refactor → Change Signature）能自动更新所有调用处，但只做语法层面的修补：比如给函数加一个必填参数 userId: string，它会在每一处调用后插入 undefined 或空字符串，而不会校验是否真该传、传什么。结果是代码能跑，但运行时抛错或逻辑跳过。
常见错误现象：TypeError: Cannot read property 'id' of undefined 出现在刚改完签名的调用点；或者接口请求因 userId 是空字符串而返回 401。
- 改前先 grep 全局：执行
Find → Find in Path搜原函数名，确认所有调用点都处于你可控范围内（比如没被eval()、new Function()或模板字符串动态拼接） - 若函数被导出并供其他包使用，
Change Signature不会更新外部项目里的调用——它只作用于当前 WebStorm 索引范围 - Vue SFC 的
<script setup></script>中通过defineExpose暴露的方法，重签名后需手动检查暴露字段是否仍匹配调用方预期
参数顺序和默认值必须显式声明，否则调用处不更新
Change Signature 不会自动推断“哪个参数该有默认值”，也不会按使用频率重排参数。如果你把 (a: number, b: string) 改成 (b: string, a: number = 0)，所有旧调用仍保持 fn(1, 'x') 形式，但实际传给了 b，导致类型错位。
关键限制：
- 新增参数必须带明确默认值（如
userId: string = ''），否则 WebStorm 会拒绝保存变更，提示 “Parameter has no default value” - 移除参数时，如果某处调用是解构传参（如
fn({ userId, token })），Change Signature不会删掉对象里多余的字段——它只动函数定义和直接调用，不动参数对象结构 - TS 接口方法签名同步？不会。
interface ApiClient { fetchUser(id: string): Promise<user> }</user>里的方法改了，Change Signature不会自动更新该接口定义，得手动改或配合Find → Replace in Path
Vue 组件方法重签名后，setup 外部调用不更新
在 Vue 3 <script setup></script> 中定义的函数（如 const handleSubmit = (data: Form) => {...}），用 Change Signature 修改后，IDE 只更新当前文件内所有调用，以及 defineExpose 暴露后的引用。但以下情况完全不覆盖：
-
ref绑定的事件处理器：比如<form></form>不会变，因为这是模板字符串，非 AST 调用 - 父组件通过
template ref调用：如childRef.handleSubmit()，Change Signature不分析模板中对 ref 的属性访问 - 路由守卫、Pinia action、
onMounted回调里直接调用的函数，只要不在当前setup作用域内显式写，就不会被识别为“调用处”
验证是否生效最简单的方式：改完后，在模板里点住 handleSubmit 按 Ctrl+B，看能否跳转到新签名；跳不到，说明模板引用未同步。
TS 类型参数和泛型函数签名不能靠 Change Signature 自动推导
对泛型函数如 function map<t u>(list: T[], fn: (item: T) => U): U[]</t>，Change Signature 允许你增删普通参数，但无法安全修改类型参数 T 或 U —— 它会报 “Cannot refactor: type parameter cannot be changed” 或静默忽略。
同样，带约束的泛型（如 <t extends record any>></t>）或条件类型中的参数，Change Signature 基本不处理。这类改动必须：
- 手动编辑函数声明，并确保所有调用点的类型实参（如
map<string number>(...)</string>）同步更新 - 检查
.d.ts声明文件是否引用了该函数；如有，需单独打开并手动改，Change Signature不跨语言边界 - 改完立刻运行
tsc --noEmit，别依赖 WebStorm 的 TS Server 实时提示——缓存可能延迟报错
最易被忽略的是：函数被 export default 导出后，其类型签名还可能被其他文件的 typeof 或 ReturnType 引用，这些地方 Change Signature 完全不触达。
