全局搜索和替换必须用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS），Ctrl+R 仅限当前文件；使用「Replace in Path」时需填写 Text to find 和 Replace with，可选 Regex、File mask、Match case、Words only 等选项，正则中捕获组用 $1 引用，$0 表示全匹配，含换行需勾选 .\n；Scope 比 File mask 更精准，支持自定义目录范围并持久化；替换后须运行 phpstan 等静态分析，并手动检查注解、模板、SQL 等易遗漏位置。
全局搜索和替换必须用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）
快捷键 Ctrl+R 只在当前文件内替换，很多人误以为它能跨文件操作，结果改了一半发现其他文件没动。真正批量改全项目，得用「Replace in Path」——也就是上面那个组合键。
触发后弹出的对话框里，Text to find 和 Replace with 是必填项；勾选 Regex 才支持正则，不勾选就是纯文本匹配；File mask 很关键，默认是 *，但如果你只想改 .php 文件，就得填 *.php，否则 JS、CSS、甚至 .gitignore 里的字符串也可能被误替换。
- 替换前务必点
Find预览匹配结果，别跳过这步 - 如果项目用了 Composer 自动加载，改类名/命名空间时，光靠字符串替换不够，还得同步更新
composer.json的 autoload 配置 -
Match case和Words only勾选与否，直接影响是否把user替换成admin后，username也跟着变成adminname
正则替换要小心捕获组编号和转义
比如想把所有 echo 'xxx'; 改成 Log::info('xxx');，写正则 echo\s+'([^']+)';，替换字段就得用 Log::info('$1'); —— 注意这里用的是 $1，不是 \1（PhpStorm 用美元符号引用捕获组）。
常见翻车点：.、+、*、? 这些元字符不加反斜杠就当字面量处理；而路径分隔符 / 在正则里不用转义，但在 PHP 字符串里写双引号时，"\/" 反而多余；另外，$0 表示整个匹配内容，$1 开始才是括号捕获的内容，别数错。
立即学习“PHP免费学习笔记（深入）”；
- 测试正则建议先在
Find模式下验证，看高亮是否准确 - 含换行的匹配需勾选
.\n（即Dot matches newline），否则.*到行尾就停了 - 替换字段里如果真要输出
$符号，得写成$$，否则会被当成变量引用
作用域（Scope）比文件掩码更精准，适合按模块/目录筛选
点击搜索框右上角的 ... (three dots)，能打开 Scope 设置。默认的 All Places 是全项目，但如果你正在重构 app/Models 下的类，直接选 Custom scope → Selected directories，然后框选该目录，后续所有查找/替换都只在这个范围生效。
比起反复修改 File mask，Scope 更稳定：它记住了目录路径、是否包含子目录、是否排除 vendor 或 tests —— 尤其当你频繁在同一个逻辑区域做替换时，保存一个自定义 Scope（比如叫 API v2 Refactor）能省下大量重复设置时间。
- 已保存的 Scope 会在下次打开
Replace in Path时出现在下拉菜单里 - Scope 不影响正则逻辑，但它决定“在哪找”，优先级高于
File mask - 如果替换了某个配置文件（如
config/app.php）里的键名，记得检查是否被其他地方通过config()动态读取，这种不会被静态扫描到
替换后记得立刻运行 phpstan 或 phpcs，别信“没报错就完事”
字符串替换是机械操作，不理解语义。比如把 $user->getName() 替成 $user->getFullName()，如果新方法返回类型变了（比如从 string 变成 ?string），静态分析工具会立刻报 NullReference 类型错误；又或者把 array_merge($a, $b) 改成 [...$a, ...$b]，PHP 7.4+ 才支持，旧环境直接 fatal error。
- 替换完成后，至少执行一次
phpstan analyse --level=5（或你项目设定的等级） - 如果有类型断言（
@var注解）或 PHPDoc 跟着旧变量名写，它们不会自动更新，得手动扫一遍 - 数据库迁移文件、SQL 字符串、前端模板里的 PHP 变量名（如 Blade 中的
{{ $user->name }}）容易被漏掉，建议用File mask单独跑一遍*.blade.php和*.sql
批量替换不是终点，而是验证链的起点。最麻烦的往往不是改了多少处，而是某一处没改，或者改得不够彻底，等上线后才暴露。
