全局搜索失效主因是作用域、文件类型、编码或索引状态任一出错；需检查scope设为project、确认utf-8编码与php文件类型识别、重建索引并排除干扰目录。
全局搜索在 PhpStorm 里不是“搜不到”，而是默认不搜你认为它该搜的地方——作用域、文件类型、编码、索引状态，四者错一个，Ctrl+Shift+F 就像扔进水里的石头，连个响儿都没有。
Scope 选错，等于没搜
默认的 All Places 看似全量，实则会跳过 vendor、node_modules、.git 这类被标记为 Excluded 的目录。右键点 vendor → Mark Directory as → Excluded 是 PhpStorm 的常规操作，但这也意味着它不会参与任何文本搜索。
- 确认 Scope：搜索框右上角下拉菜单必须手动选成
Project或自定义范围，不能是Current File或Open Files - 多模块项目（如
packages/）需点击Edit Scopes→ 添加对应路径，否则这些目录压根不进扫描队列 -
File mask（如*.php）是过滤器，不是作用域；它只筛文件后缀，不决定目录是否被纳入索引
中文/特殊字符搜不到？先看编码和文件类型
Ctrl+F 在单个文件里能搜到中文，但 Ctrl+Shift+F 全局搜不到，90% 是因为文件实际编码不是 UTF-8，或者 PhpStorm 没把它识别为可索引的 PHP 文件。
- 用
Ctrl+F在目标文件内试搜中文：能搜到 → 编码没问题；搜不到 → 文件可能是 GBK/GB2312，需右键 →Reload file with encoding→ 选 UTF-8 并Convert - 检查
Settings → Editor → File Types：确认*.php在PHP files列表里，而不是被误归入Text files - JSON/YAML 配置文件默认不参与 PHP 范围搜索，要搜里面的内容，Scope 得切到
All Places，或手动加*/.json到自定义范围
Replace in Path 替换前不预览，等于闭眼开车
Ctrl+Shift+R 触发的是 Replace in Path，不是魔法按钮。它不区分语义，只做字符串匹配——user 会把 username、user_id、is_user 全卷进去，除非你管住它。
- 务必先点
Find，看高亮结果是否符合预期；别跳过这步 - 勾选
Preview usages，弹窗里逐条确认替换位置，尤其注意注解、SQL 字符串、模板变量这类易漏区域 - 正则替换时：
$1引用捕获组，$0是全匹配；真要输出$符号得写成$$，否则会被当变量解析 - 含换行的匹配必须勾选
.（Dot matches newline），否则.*到行尾就停了
Search Everywhere（双击 Shift）搜不到类名？索引可能卡住了
双击 Shift 搜 UserRepository 没结果，不是快捷键失效，而是索引没建好或关键目录被排除了。
- 看右下角状态栏：有
Indexing...或Scanning files...？等完再试 - 手动重建索引：
File → Reload project from Disk或点击索引条右侧齿轮 →Rebuild Index - 检查
Settings → Directories：确认src、app这类目录没被误标为Excluded - Composer 类未加载？运行
composer dump-autoload，否则新类即使存在也不会进索引
真正麻烦的从来不是“怎么搜”，而是搜出来一堆结果后，分不清哪些是调用、哪些是定义、哪些是字符串字面量——这时候得切回 Alt+F7 查用法，而不是继续靠 Ctrl+Shift+F 硬扫。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
