如何调整PhpStorm全局查找范围-webstorm-PHP中文网

全局搜索搜不到vendor或packages目录，是因为它们被标记为excluded，不参与索引；需在find in path中切换scope为all places或自定义范围才能临时包含，但性能下降。

如何调整phpstorm全局查找范围

因为 PhpStorm 默认把 vendor/、node_modules/、dist/ 等目录标记为 Excluded，它们不参与索引，自然也不会出现在任何全局搜索结果里。这不是“没搜全”，而是根本没被纳入搜索通道。

常见误操作包括：只改了 File mask（如填 *.php），但没调整 Scope；或以为 .gitignore 能控制 PhpStorm 索引——它完全无效。

确认目录状态：右键目标文件夹 → Mark Directory as → 查看是否显示 Excluded
临时启用：在 Find in Path（Ctrl+Shift+F）右上角 Scope 下拉菜单中选 All Places 或自定义范围
永久加入：点击 Scope → Edit Scopes → 新增目录路径（如 packages/my-lib），勾选 Include subdirectories

File mask 是临时过滤器，只影响本次搜索；Scope 是作用域定义，决定哪些路径能被搜索到——两者逻辑不同，不能互相替代。

比如你想批量替换所有 PHP 文件里的某个字符串，但不想碰 .env 或日志：File mask 填 *.php 就够了；但如果你连 tests/ 都不想扫，就得在 Scope 里明确排除它，否则 *.php 仍会命中 tests/ 下的 PHP 文件。

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

下载

File mask 填法：用英文分号分隔，如 *.php;*.blade.php；带路径前缀更稳，如 app/Http/Controllers/*.php
Scope 选 Project Files 是默认值，但可能漏掉软链接或子模块；All Places 会包含 vendor/，但性能明显下降
别混用：如果 Scope 已限定为 src/，再填 *.js 的 File mask 就毫无意义——src/ 下压根没 JS 文件

这些文件被搜到不是因为“匹配上了内容”，而是它们在项目索引里——PhpStorm 默认索引整个项目根目录下所有文件，不管后缀或用途。

仅靠 File mask 过滤是治标；真正切断源头，得让 PhpStorm 彻底停止索引它们。

对单个文件：右键 .env → Mark as Plain Text（仅去高亮，不阻止索引）→ 不够，还得进 Settings → Directories 手动添加排除路径
对目录：右键 storage/logs/ → Mark Directory as → Excluded（图标变灰红，状态栏提示 Indexing paused for excluded files）
验证是否生效：进入 Settings → Directories，确认路径出现在 Excluded 列表；之后 Find in Path 就不会再扫到它们，无论 File mask 填什么

不能。它不走 Find in Path 流程，也不响应 File mask 或 Scope 设置，它的结果完全依赖后台索引状态和类型前缀指令。

搜不到文件或类，大概率是索引没建好，或者关键目录被误标为 Excluded，而不是“范围没调对”。它只支持前缀语法缩小结果类型，比如 file .env 或 class UserController，但无法排除某类路径。

索引卡住时，右下角会显示 Indexing…，等它消失或手动 Rebuild Index
搜 /config/ 可以，但搜 config（无斜杠）基本无效——Search Everywhere 只识别带斜杠的路径段
想彻底屏蔽某类文件？只能从索引源头处理：把对应目录设为 Excluded，或在 Settings → Editor → File Types 中将扩展名设为 Ignore files and folders（注意：这仅降级 UI，不阻止索引）