搜索无结果首要检查右下角是否显示“indexing completed”，索引未完成或损坏会导致ctrl+shift+f、ctrl+shift+n及双击shift全部失效；需点击索引条齿轮→rebuild index，或执行file→invalidate caches and restart。

搜索完全没结果？先看右下角有没有“Indexing completed”

搜不到不是设置错了，是索引根本没建好。PhpStorm 的 Ctrl+Shift+F、Ctrl+Shift+N、双击 Shift 全部依赖后台索引，一旦中断或损坏，所有搜索都变摆设。

检查右下角状态栏：如果显示 Indexing…、Scanning files… 或压根没提示，就别调设置，先等或强制重建索引。

• 点索引条右侧齿轮图标 → Rebuild Index（比 Reload project from Disk 更彻底）
• 若卡住或反复失败，直接执行 File → Invalidate Caches and Restart… → Invalidate and Restart
• 重建期间别操作项目，尤其别删 .idea/index/ 下的文件——那是索引库本体，手动删等于自毁

作用域选成 “Project” 但还是搜不到？检查目录是否被 exclude

默认的 Project scope 看似全量，实则自动跳过所有标为 Excluded 的目录。而 vendor、node_modules、dist 这些目录，只要右键点过 Mark Directory as → Excluded，就彻底退出搜索队列。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 进 Settings → Directories，逐个确认 src、app、packages 等关键路径没被误标为 Excluded
• Excluded 和 Ignored 不同：Ignored 是 Git 层面，Excluded 是 PhpStorm 索引层，后者才真正屏蔽搜索
• 多模块项目（如 Lerna/Yarn Workspaces）需手动在 Edit Scopes 里添加对应路径，否则 packages/foo 根本不进扫描范围

中文、类名、方法名搜不到？文件类型和编码可能没对上

Ctrl+F 在单文件里能搜到中文，但全局搜不到，90% 是因为文件没被识别为 PHP，或编码不是 UTF-8。

• 右键目标文件 → Override File Type → PHP，否则 class UserRepository 不会进 AST 索引，只当普通文本扫
• Ctrl+F 在该文件内试搜中文：能搜到 → 编码 OK；搜不到 → 右键 → Reload file with encoding → UTF-8 并勾选 Convert
• 进 Settings → Editor → File Types，确认 *.php 在 PHP files 列表里，而不是躺在 Text files 或 Auto-detect 下

正则搜索失效或替换错乱？别漏掉三个硬开关

正则不是开个选项就完事，Find in Path 里它有三道闸门，缺一不可。

• 必须点击搜索框右下角 .* 图标（变蓝才算激活），快捷键 Ctrl+Alt+R 有时被系统占用，不能信
• 跨行匹配要勾选 . matches newline（图标是 \n），否则 public.*function 永远停在第一行末尾
• 替换时写 $1 引用捕获组，但 $ 符号本身要输出得写成 $$，否则会被当变量解析

最常被忽略的是：正则生效的前提是作用域没锁死在 Open Files，且 File mask 填了 *.php —— 否则它会在 .log 和 .zip 里徒劳地跑正则，还报 Invalid regex for file type。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！