应选“all places”或自定义scope并取消excluded状态：phpstorm默认scope排除vendor/node_modules，需手动切换scope；excluded目录彻底不索引，与.gitignore无关；file mask仅限本次搜索后缀，不支持!排除；search everywhere无scope/file mask控制。

Scope下拉菜单选错导致搜不到 vendor 或 node_modules

默认的 Scope 是 “Project Files”，它会自动排除 vendor、node_modules、.git 等目录——不是漏搜，是压根不进搜索通道。想搜第三方包里的内容，必须手动改 Scope：

• 点击 Find in Path（Ctrl+Shift+F）右上角的 Scope 下拉框
• 选 All Places：最暴力，搜所有已索引路径（含被标记为 Excluded 的目录，但前提是它们没被彻底排除）
• 或选 Custom → Edit Scopes → 添加具体路径，比如 vendor/myorg/sdk/src
• 注意：如果目录已被设为 Excluded（图标变灰红），即使加进 Custom Scope 也无效，得先取消 Excluded

Excluded 目录会彻底绕过搜索，和 .gitignore 无关

.gitignore 对 PhpStorm 搜索完全无影响。真正起效的是 Directories 设置里的 Excluded 状态：

btpanel phpsite 宝塔面板PHP网站

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

下载

• 右键目录 → Mark Directory as → Excluded，该路径下所有文件不再参与索引和搜索
• 验证方式：进入 File > Settings > Directories，看目标路径是否出现在 Excluded 列表里
• 常见误操作：Settings > Editor > File Types > Ignore files and folders 里加 *.log，这只是 UI 隐藏，不影响后台扫描
• 危险操作：把 vendor/autoload.php 所在目录标为 Excluded，会导致整个 PSR-4 类加载失效，代码补全瘫痪

File mask 是临时过滤，填错格式等于没填

File mask 是 Find in Path 底部那个输入框，只控制本次搜索的文件后缀范围，不改变索引：

• 合法写法：*.php;*.env;storage/logs/（英文分号分隔，目录末尾带斜杠更可靠）
• 非法写法：*.php, *.env（逗号）、*.log ; *.env（空格）、**/*.php（冗余，没必要）
• 想排除日志但保留配置？填 *.php;*.yml;!.log 不行——PhpStorm 不支持 ! 排除语法，只能正向列举要搜的类型
• 搜 *.php 却没结果？检查是否误输成 *. php（空格）或中文分号

Search Everywhere（双击 Shift）不走 Scope 和 File mask 流程

Search Everywhere（双击 Shift）的搜索逻辑和 Find in Path 完全不同，它依赖底层索引，没有 Scope 和 File mask 控制项：

• 它不能通过设置过滤掉 .env 或 storage/logs/，除非这些路径本身被 Excluded
• 支持前缀限定，如 file .env 或 class UserRepository，但无法排除某类后缀
• 搜路径必须带斜杠：/config/ 可以，config 不行；routes/web 无效，/routes/web/ 才可能命中
• 如果搜不到刚新建的文件，大概率是索引延迟，按 Ctrl+Alt+Y 强刷一次索引比调 Scope 更管用

真正卡住人的，往往不是找不到设置入口，而是分不清 Scope、Excluded、File mask、前缀指令这四层控制各自生效的位置和优先级。

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