Shift+F6是安全重命名函数名的唯一推荐方式，基于AST分析作用域并自动更新所有静态引用；而Ctrl+R纯文本替换会误改注释、字符串、SQL及无关同名标识符，导致运行时错误。
用 Shift+F6 重命名函数名，不是 Ctrl+R 文本替换
直接 Ctrl+R 搜 oldFunctionName 并替换成 newFunctionName 是最危险的操作——它会把注释里的 // call oldFunctionName()、SQL 字符串里的 'SELECT * FROM oldFunctionName'、甚至类名 OldFunctionNameService 全部误改。真正安全的方式只有一种：Shift+F6，且光标必须停在函数定义的函数名上（比如 function oldFunctionName 中的 oldFunctionName）。
PhpStorm 会基于 AST 分析调用链：它能识别 oldFunctionName()、self::oldFunctionName()、static::oldFunctionName()，但不会碰 call_user_func('oldFunctionName') 或 $callback = 'oldFunctionName'。
常见错误现象：
- 重命名后报
Call to undefined function newFunctionName()—— 实际是动态调用漏了 - IDE 跳转失效或提示 “Cannot find declaration” —— 函数定义没被正确索引，可能因 PHP 解释器未配置或
composer.jsonautoload 未生效
动态调用和字符串类名必须人工核对
PhpStorm 的静态分析无法覆盖运行时行为。以下写法 永远不会 被 Shift+F6 捕获，必须手动搜索替换：
立即学习“PHP免费学习笔记（深入）”；
-
call_user_func('oldFunctionName')和call_user_func([$obj, 'oldFunctionName']) -
function_exists('oldFunctionName')、is_callable('oldFunctionName') -
eval("oldFunctionName();")（虽然你真这么写就该被开除） - 硬编码在 JSON 配置、YAML、SQL 文件或前端 JS 字符串中的
"oldFunctionName"
实操建议：重命名完成后，立刻执行 Ctrl+Shift+F 全局搜 'oldFunctionName' 和 "oldFunctionName"，范围选整个项目，勾选 Match case 和 Words only，逐条确认是否需同步修改。
重命名后别忘了检查函数签名和类型提示
如果函数有参数或返回值类型声明，Shift+F6 只改名字，不自动更新 PHPDoc 注解或类型信息。这会导致 PHPStan 报错、IDE 补全失效、LSP 提示不准。
例如原函数：
/**
* @param int $id
* @return User|null
*/
function oldFunctionName(int $id): ?User { ... }重命名后变成：
/**
* @param int $id
* @return User|null
*/
function newFunctionName(int $id): ?User { ... }看着没问题，但如果你之前用了 @deprecated 或自定义注解（如 @psalm-param），它们不会自动迁移。更关键的是：如果函数被其他地方用 callable 类型约束（如 function process(callable $cb)），调用方代码里传的 'oldFunctionName' 字符串依然没变——这属于语义断层，IDE 不会提醒。
跨文件调用更新失败？先查索引和作用域
有时你在 A.php 里重命名了函数，B.php 中的调用却没更新，原因通常不是 PhpStorm 失效，而是：
- B.php 没被正确加入项目索引（右键目录 →
Mark Directory as → Sources Root） - A.php 和 B.php 使用了不同 PHP 语言级别（File → Settings → Languages & Frameworks → PHP → Language level 不一致）
- 函数定义在条件块里（如
if (false) { function oldFunctionName() {} }），PhpStorm 认为不可达，跳过索引 - 调用点用了完全限定名
\oldFunctionName()，但重命名时没勾选Search in comments and strings，导致前导反斜杠未同步
验证是否被识别：把光标停在函数调用处按 Ctrl+Click，能跳转到定义才说明索引正常。跳不到？先 File → Reload project from Disk 或 File → Invalidate Caches and Restart。
最易被忽略的一点：函数重命名后，如果它被用作事件监听器名、路由回调、或配置项值（如 Laravel 的 Route::get(..., 'oldFunctionName')），这些字符串引用不会自动更新，必须靠 Ctrl+Shift+F 手动扫一遍，否则上线就 500。
