Ctrl+R是当前文件替换的唯一快捷键，仅用于单文件替换；全局替换必须用Ctrl+Shift+R（Win/Linux）或Cmd+Shift+R（macOS），且需注意Scope、File mask、Regex启用及编码匹配等关键设置。
Ctrl + R 是当前文件替换的唯一快捷键
别用 Ctrl + F 或 Ctrl + Shift + F 去替换——它们只负责查找，不带替换功能。真正能在当前文件里改文本的，只有 Ctrl + R（Windows/Linux）或 Cmd + R（macOS）。很多人误按 Ctrl + F 后直接敲回车，结果什么都没变，是因为它压根没进入替换流程。
-
Ctrl + R弹出的是「Replace in File」面板，左侧填原文，右侧填新内容 - 默认不启用正则，想用
.*、\d+这类写法，必须点右上角的.*图标手动开启 Regex 模式 - 如果只是改个变量名（比如
$user→$member），勾选Words only能避免把$username也一起替换成$membername - 替换前先点
Find预览，尤其注意是否匹配到注释里的字符串——比如// $user is deprecated也会被扫进来
Ctrl + F7 查当前文件所有使用位置最轻量
当你选中一个函数名、变量或常量，按 Ctrl + F7，PhpStorm 会在当前文件里高亮它所有出现的地方，并在弹窗里列出每一处位置。这不是全局搜索，不进 vendor、不扫 tests，响应快、干扰少。
- 适合快速确认某个
self::STATUS_ACTIVE在本文件里用了几次、都在哪行 - 比
Alt + F7（全工程查找）省资源，尤其打开大文件时不会卡顿 - 如果光标没落在标识符上（比如停在括号里或空格后），
Ctrl + F7会失效，先按Esc确保焦点回到编辑器再试 - 结果列表支持回车跳转，也支持鼠标悬停看上下文，但双击不能直接编辑——得手动切回去改
Regex 替换容易错的三个地方
正则替换不是写完就跑，Ctrl + R 里开 Regex 后，捕获组引用、元字符转义和换行处理这三块最容易翻车。
- 捕获组用
$1、$2引用，不是\1；$0是整个匹配内容，别和$1搞混 - 想匹配换行？必须勾选
.下方的.\n（Dot matches newline），否则.*到行尾就停了 - 搜索字段里粘贴的字符串，PhpStorm 不会自动转义元字符；比如你复制了
function foo()，里面括号是字面量；但若手输foo\(\)，就得自己加反斜杠 - 替换字段里真要输出
$符号，得写成$$，否则会被当成变量引用解析掉
Scope 和 File mask 决定你动的是哪部分代码
哪怕你只打算改当前文件，也得留意 Ctrl + R 面板右上角的 Scope 设置——它可能被之前操作污染，比如上次设成了 Tests，这次没改回来，就会找不到任何匹配项。
立即学习“PHP免费学习笔记（深入）”；
- 默认 Scope 是
All Places，但如果你刚在「Find in Files」里设过自定义范围，Ctrl + R有时会继承它 - 临时保险做法：每次打开
Ctrl + R后，先看一眼 Scope 下拉框是不是Project Files或Current File - File mask 默认是
*，如果只想改 PHP 文件，务必改成*.php，否则 JS、CSS、甚至.env里的字符串都可能被波及 - Scope 比 File mask 更底层，比如设成
Custom scope → app/Http/Controllers，那哪怕你填了*.php，也不会扫到app/Models下的文件
Ctrl + Shift + R 配合 File mask 手动扫一遍。 
