Excluded目录在PhpStorm中不生效是因为该设置仅影响IDE自身功能（如导航、高亮），不阻止Composer、PHPStan、PHPUnit等外部工具扫描；需同步修改对应工具配置（如phpstan.neon、phpunit.xml）才能彻底忽略。
为什么 Excluded 目录在 PhpStorm 中不生效？
常见现象是：右键目录选了 Mark as Excluded，但文件依然被索引、补全、搜索命中，甚至单元测试还在跑被排除的测试文件。根本原因不是操作没成功，而是 PhpStorm 的排除逻辑分两层——Project Structure 设置只影响 IDE 自身感知（如导航、高亮），但不会阻止外部工具（如 Composer autoload、PHPStan、PHPUnit）扫描这些路径。真正要“忽略”，得让 PhpStorm 和底层工具都同步“看不见”。
Mark as Excluded 该用在哪些目录？
适合标记为 Excluded 的，是那些纯生成物、临时文件、或与当前开发无关的第三方资产：
-
vendor/—— 如果你用的是全局 Composer autoloader 或远程调试，本地vendor可排除以加快索引（但注意：排除后Ctrl+Click进不到第三方类定义） -
node_modules/—— 前端混合项目中，PHP 文件几乎不依赖它，排除可显著降低内存占用 -
var/cache/、storage/logs/、runtime/—— Laravel/Symfony/Yii 等框架的运行时目录，内容动态生成，无阅读/编辑价值 -
build/、dist/、.idea/（不建议手动排除，IDE 自己管）
别排除 tests/ 或 src/ 下的子目录——它们需要被分析才能提供补全和重构支持。
排除后仍被搜索或跳转？检查这三项
排除目录后还搜得到、还能 Ctrl+Click 进去，大概率是以下某个环节没断干净：
立即学习“PHP免费学习笔记（深入）”；
- 确认排除动作是在 Project 视图 下操作的，不是在
Scratches and Consoles或Version Control标签页里点的（后者无效） - 检查
Settings > Editor > File Types > Ignore files and folders，这里填的是全局通配规则，比如*.log;*.tmp;cache/，它比目录级Excluded优先级更高，且影响搜索范围 - 如果你用了
PHP @psalm-suppress或自定义 PHPDoc 标签，某些插件（如 Psalm plugin）会绕过Excluded设置重新加载文件——关掉对应插件再试一次
想彻底屏蔽某目录参与所有 PHP 分析？用 phpstan.neon 或 phpunit.xml
IDE 层面的 Excluded 解决不了静态分析工具的扫描。比如你排除了 tests/legacy/，但 phpstan 仍在报错，就得改配置文件：
parameters:
excludePaths:
- tests/legacy/**同理，phpunit.xml 中删掉或注释掉对应 <directory> 节点；Composer 的 autoload-dev 里也别映射被排除的测试路径——否则即使 IDE 不索引，php -f vendor/autoload.php 仍会加载它们。
最易被忽略的一点：Excluded 是 IDE 级别的视觉隔离，不是访问控制或加载拦截。它不改变 include_path，也不影响 require 行为。真要阻止运行时加载，得靠自动加载配置或条件判断，而不是右键点一下。
