PhpStorm重命名变量/函数必须用Shift+F6，它默认只改代码中语义相关引用，不处理注释和字符串；如需同步修改需勾选“Search in comments and strings”，但类名重命名后须手动执行composer dump-autoload并核对PSR-4映射。
重命名变量/函数时没改引用？检查是否启用了“Search in comments and strings”
PhpStorm 默认只在代码上下文中重命名，如果变量名出现在注释或字符串里（比如日志模板 "User {$user->id} logged in"），它不会自动替换——但你可能误以为“没生效”。这不是 bug，是默认安全策略。
- 执行重命名前，按
Shift+F6（Windows/Linux）或Fn+Shift+F6（macOS），弹出对话框后勾选Search in comments and strings才会一并处理 - 不勾选时，
$user重命名为$currentUser，但注释里的// $user is not null不变；勾选后才会同步改掉 - 但注意：勾选后若字符串里有拼接逻辑（如
'user_' . $id），它不会解析变量，只做字面匹配，所以不会误伤
类名重命名后 Composer 自动加载失效？别忘了更新 PSR-4 映射
重命名一个类（比如 UserRepository → UserDataRepository）后，即使文件名、类声明、use 语句都改了，composer dump-autoload 仍可能报 Class not found。
- 原因通常是
composer.json中的psr-4映射还指向旧命名空间路径，比如"App\Repositories\": "app/Repositories/"没问题，但如果你把类移到了app/Repositories/Data/，却没同步更新命名空间和 composer 配置，就会断链 - 重命名类后，先确认
namespace声明是否匹配新路径，再运行composer dump-autoload -o - 如果用的是 PhpStorm 的
Refactor → Rename（右键类名 → Rename），它默认会同步改命名空间和use，但不会动composer.json—— 这块得手动核对
批量修改多个文件中的相同变量名？别用“Replace in Path”，用“Refactor → Rename”更安全
想把整个项目里所有 $tmp 改成 $temp？直接搜“Replace in Path”风险极高：可能误改 JSON 值、SQL 字符串、配置项，甚至第三方 vendor 代码（虽然加了排除，但容易漏）。
- 正确做法：在任意一个
$tmp变量上按Shift+F6，PhpStorm 会分析作用域，只改该变量实际定义及有效引用范围（比如局部变量只改当前函数内，类属性只改该类及其子类中调用） - 如果真要跨作用域强制统一改（比如全局常量名），先确认它是
const或define()定义的，然后对常量名本身执行Shift+F6，它会识别所有self::XXX、ClassName::XXX、XXX引用 - 执行前看预览窗口：左侧是变更位置，右侧是变更后代码，点击行可跳转定位；如果有灰色条目（表示“未识别为引用”），说明 PhpStorm 不确定是否该改，这时候别强行全选
重命名后 Git 提交显示“deleted/created”而不是“renamed”？文件名没同步改
重命名类 User.php → UserEntity.php，但只改了类名和命名空间，没改文件名，Git 就无法识别为重命名操作，而是当成删旧文件 + 新建文件，历史记录就断了。
立即学习“PHP免费学习笔记（深入）”；
- PhpStorm 对 PHP 类重命名时，默认不改文件名（除非你勾选了
Rename file选项）；这个勾选项在Shift+F6对话框底部，只有当类名与文件名强关联（如 Laravel 的控制器、Laravel Octane 的 worker 类）时才建议打开 - 如果已提交过旧文件，又手动改了文件名，记得用
git mv User.php UserEntity.php再提交，否则 Git 状态里会同时出现deleted: User.php和new file: UserEntity.php - PHP 文件名大小写敏感（尤其 Linux 服务器），重命名时避免只改大小写（如
user.php→User.php），Git 在 macOS/Windows 上可能检测不到变化
