phpstorm的shift+f6重命名仅处理符号引用（如类名、use语句），不自动更新require/include中的字符串路径；此类路径属“文本引用”，需手动启用search in comments and strings或全局搜索替换。
文件重命名后引用没更新，不是 PhpStorm “忘了”，而是你没用对重构入口——Shift+F6 仅对单文件生效且依赖上下文；多文件批量改名、路径硬编码、PSR-4 映射错位、动态调用等场景，它压根不处理。
为什么 Shift+F6 重命名后还有 require 路径报错
因为 require 和 include 是运行时语句，PhpStorm 的静态重构默认不扫描它们中的字符串路径。哪怕你用 Shift+F6 重命名了 UserController.php，像 require 'app/Http/Controllers/UserController.php'; 这种写法也不会被自动修正。
- 这类路径属于“文本引用”，必须手动开启
Search in comments and strings才可能捕获（但仅限当前文件内） - 跨文件的
require路径，Shift+F6完全无视——它只管符号引用（如use、new、类名跳转） - 如果路径是拼接出来的，比如
require $base . '/UserController.php';，那连Search in comments and strings都救不了，只能Ctrl+Shift+R全局搜
Move 操作后 namespace 和 use 语句漏更新的真正原因
不是 PhpStorm 抽风，是你没满足 PSR-4 自动推导的四个硬性条件：目录必须标记为 Sources Root、composer.json 里有合法 psr-4 映射、文件路径与 namespace 严格对应、且 namespace 声明在文件首行（<?php 后无空行或 declare）。
- 移动前检查
src/Http/Controllers/UserController.php的第一行是不是namespace App\Http\Controllers; - 移动目标路径必须能反向推导出新 namespace，比如移到
src/Domain/Http/UserController.php，IDE 才可能改成App\Domain\Http -
use语句不更新？先确认目标目录下没有同名类冲突（哪怕在不同 namespace 下），有冲突 IDE 就会放弃自动修正 -
vendor/autoload.php必须被标记为PHP Include Root，否则 PSR-4 映射不会被加载进索引
硬编码路径和配置项怎么补救
重命名完成后发现 config/app.php 里还写着 'controller' => 'UserController'，或者注释里留着旧路径示例？这些都逃不过 Shift+F6 的雷达，得靠 Ctrl+Shift+R（Replace in Path）手动兜底。
- 搜索范围选
All Places，勾选Match case和Words only避免误替换（比如搜User别把Username也替了） - 正则模式慎开：除非你确定要替换所有
UserController\.php形式，否则关掉更安全 - 特别注意
@see、@deprecated、@var注解里的类名，它们不会被重构识别，必须人工 grep 或Ctrl+Shift+R扫 - Composer service 容器注册点（如
app('OldService')、bind('OldService', ...)）全部是字符串，必须单独搜
重命名后类找不到、跳转失败的隐藏环节
最常被跳过的一步：重命名类文件后，composer dump-autoload -o 没跑，导致 vendor/composer/autoload_psr4.php 里的映射还是旧的，PhpStorm 索引读不到新路径，自然标红。
- 改完文件名、namespace、use 语句后，立刻在终端执行
composer dump-autoload -o - 然后
File → Invalidate Caches and Restart → Invalidate and Restart，强制 IDE 重新读取 autoload 映射 - 别信“刚改完就跳转成功”——检查右下角是否出现
Indexing finished，没完成前所有跳转都是缓存假象 - 如果用了 Laravel，还要确认
config/cache.php里的classmap或files数组没硬编码旧路径
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
