必须用shift+f6重命名函数名，因其基于ast进行符号级重构，自动更新所有调用点、继承链和类型提示；而ctrl+shift+r等文本替换会误改字符串、注释及无关同名内容，导致运行错误或逻辑崩坏。
直接重命名函数名必须用 Shift+F6，不是正则替换，也不是 Ctrl+Shift+R 批量改字符串——后者会漏掉调用点、毁掉类型推导、跳过继承链，且无法识别动态调用。
为什么不能用 Replace in Path 改函数名
函数名不是孤立字符串，它在代码中承担语义角色：声明、调用、继承、类型提示、IDE 补全都依赖上下文分析。Ctrl+Shift+R 只做字面匹配，典型翻车场景包括：
-
$obj->getUser()被替成$obj->getAdmin()，但getUser是接口方法，子类实现也得同步更新，而文本替换完全不管这个 -
function getUser(): User替换后变成function getAdmin(): User，返回类型注解还在，但 IDE 不再能跳转到原定义，PHPStan 也会因签名变更报错 -
call_user_func([$obj, 'getUser'])中的'getUser'是字符串，Shift+F6明确跳过它；但Ctrl+Shift+R会把它一起改掉，导致运行时报Method not found - 如果函数被
use function AppHelpersgetUser;导入，文本替换不会更新use语句，造成符号未定义
Shift+F6 重命名函数的正确姿势
光标位置决定重构范围，不是你“选中了什么”，而是“光标落在哪个符号上”：
- 把光标停在函数声明的名称上（如
function <strong>getUser</strong>()的getUser），按Shift+F6，它才会识别为函数重命名 - 若光标停在调用处（如
$user = $repo-><strong>getUser</strong>();），Shift+F6会尝试重命名该调用所指向的函数——前提是 PhpStorm 已索引到定义（Ctrl+Click能跳转） - 函数参数名、局部变量名、类属性名，全部不参与本次重构，哪怕同名也不会被波及
- 重命名后，所有显式调用、
parent::、static::、接口实现、trait 引入的方法都会自动更新；但__call、反射、method_exists等仍需人工核对
哪些地方一定会漏，必须手动补
Shift+F6 再准，也只覆盖静态可分析的部分。以下三类必须人工 grep 或正则扫：
- 字符串中的函数名：
class_exists('UserRepository')、app('UserRepository')、@OA\Get(path="/users", operationId="getUser") - 路由定义里的方法名：
Route::get('/users', [UserController::class, 'getUser'])—— 这里'getUser'是字符串，但它是合法调用，Shift+F6不动它 - 配置文件或 JSON/YAML 中硬编码的函数名/回调名，比如 Laravel 的
config/logging.php里写死的'before' => 'getUser'
这类内容统一用 Ctrl+Shift+F（Find in Path），填 getUser，Scope 设为 All Places，File mask 填 *.php;*.yml;*.yaml;*.json，逐条确认是否需要改。
重命名后最易忽略的一步
函数名变了，但如果它属于某个 PSR-4 自动加载路径下的类方法，那没问题；但若这个函数是全局函数（比如 app/Helpers/functions.php 里定义的），且项目用了 Composer 的 autoload.files，就得检查 composer.json 是否仍包含该文件——否则函数加载失败，报 Call to undefined function。更隐蔽的是：某些测试文件或命令行脚本可能直接 require 了旧路径，这些不会被任何重构捕获。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
