PhpStorm如何排除大文件夹的代码索引_解决node_modules导致代码卡顿【排雷】-phpstorm-PHP中文网

必须右键mark directory as→excluded才真正生效，因ignored仅影响git提示而不阻止索引，excluded则彻底移除语义分析、搜索和补全；图标变灰红且状态栏提示“indexing paused”为生效标志，黄色图标说明未真正排除。

phpstorm如何排除大文件夹的代码索引_解决node_modules导致代码卡顿【排雷】

为什么右键 Mark as → Excluded 才真正生效

很多人点了 .gitignore 里写了 node_modules，或右键选了 Ignored，结果补全还是卡、跳转还是慢——因为 Ignored 只影响版本控制图标显示，Excluded 才让 PhpStorm 彻底跳过语法解析、符号索引和类型推导。
目录图标变红灰色才是生效标志；黄色是假排除，后台仍在扫描。

右键 node_modules → Mark Directory as → Excluded
同理处理 vendor、dist、build、storage/logs、bootstrap/cache
进 File > Settings > Directories，确认路径出现在 Excluded 区域（不是 Sources 或 Resources）
若用了 Composer path 类型本地包，必须去 Settings > Project > Project Structure > Modules 把对应路径手动设为 Sources，否则跳转会失效

排除后跳转失效？关键子路径要手动加回来

全量 Excluded vendor 后，use Illuminate\Support\Str 点不了跳转，不是配置错了，而是你把“框架本身”也一起踢出去了。解决方式不是不排，而是精准排。

先整体 Excluded vendor
再单独进入 vendor/laravel/framework（注意大小写，不能漏 framework）→ 右键 → Mark as > Sources Root（图标变蓝）
同理可加 vendor/symfony/console、vendor/monolog/monolog 等你实际依赖并需要跳转的包
这些路径必须精确匹配，多一个斜杠或少一个字母都不识别

即使标了 Excluded，IDE 还在偷偷扫？查这三处隐藏开关

排除目录后仍卡顿，大概率是其他设置开了后门，让 PhpStorm 绕过 Excluded 规则继续啃 node_modules。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

Settings > PHP > Composer：关掉 Enable auto-import for Composer packages
Settings > Editor > Inspections > PHP > Undefined class / function：关掉 Report undefined symbols in vendor directories
直接删 .idea/misc.xml 里的残留配置行：<option name="excludedPaths" value=""></option>——GUI 操作有时不彻底，手动删更稳

Linux 下 inotify 耗尽会让排除完全失效

就算你把 node_modules 标成红色，Linux 默认 inotify 句柄上限（8192）也可能被撑爆，导致 PhpStorm 卡在“正在扫描文件”，连排除状态都同步不了，现象是右键菜单延迟、保存不刷新、提示 External file changes sync may be slow。

查当前值：cat /proc/sys/fs/inotify/max_user_watches
临时调高：sudo sysctl -w fs.inotify.max_user_watches=524288
永久生效：写入 /etc/sysctl.d/60-jetbrains.conf，内容为 fs.inotify.max_user_watches=524288，再运行 sudo sysctl -p --system

这个值不是越大越好，但低于 262144 在中大型项目里基本不够用；设完必须重启 PhpStorm，不是仅清缓存。