必须从项目索引和部署上传两层面排除node_modules：右键mark as excluded，或全局设ignored files；若失效需删.idea重标或强制reload；deployment排除须单独配置，.gitignore无效。
怎么把 node_modules 彻底“看不见”？
WebStorm 一打开就卡、搜索变慢、CPU 狂升，八成是它在拼命索引 node_modules。这不是性能问题，是配置没关对地方。node_modules 必须从 项目索引 和 部署上传 两个层面排除，只做一半等于白干。
- 右键点击
node_modules文件夹 → Mark Directory as → Excluded（仅对当前项目生效） - 如果已安装依赖后才想起来：删掉项目根目录下的
.idea目录，重启 WebStorm 再标 Excluded（否则旧索引残留，标了也无效） - 全局生效更省事：进入
File > Settings > Editor > File Types > Ignored Files and Folders，点+加入node_modules（注意：不带斜杠，别写成node_modules/）
⚠️ 坑点：只加进 .gitignore 完全没用——Git 忽略 ≠ IDE 忽略。WebStorm 不读 .gitignore 来决定是否索引。
为什么“右键 Mark as Excluded”有时不生效？
常见现象：标完 Excluded，文件名还是黑色（没变灰），Ctrl+Click 仍能跳转，全局搜索还能搜到里面的内容。
根本原因只有两个：
- 当前项目用了
node_modules的符号链接（比如用pnpm link或yarn link），WebStorm 默认不递归排除软链目标 - 该目录已被 WebStorm 缓存为“已索引”，而 Excluded 是个“未来策略”，不会自动清理历史索引
解决办法：
- 检查路径是否真实存在：在终端运行
ls -la node_modules，确认不是指向别处的软链 - 强制重建索引：菜单栏
File > Reload project from disk，或删掉.idea/misc.xml中疑似缓存的node_modules条目再重启
部署时怎么防止 dist 或 .env.local 被意外上传？
Deployment 配置里，“排除”和“忽略”是两套系统：Excluded 目录不影响部署；要阻止上传，得走 Deployment 的专用排除规则。
- 打开
Tools > Deployment > Configuration - 切到
Options标签页 → 找到Exclude items by name输入框 - 填入匹配模式，例如：
dist/, .env.local, *.log（支持通配符，逗号分隔） - 注意：这个排除只作用于上传/下载，不影响本地索引或 Git 行为
⚠️ 坑点：如果同时在 Ignored Files and Folders 里加了 dist，它只会让 WebStorm 不索引，但 Deployment 依然会传——必须在 Deployment 设置里单独配。
能不能只忽略某个文件，而不是整个目录？
不能右键单个文件点 Excluded，这是 WebStorm 的硬限制（官方文档明确说“单个文件只能通过按名称排除”）。
可行路径只有两条：
- 在
Settings > Editor > File Types > Ignored Files and Folders里填文件名，例如：webpack.config.bak、secrets.json - 用通配符批量处理，例如：
<em>.tmp, </em>.swp（适用于 Vim 临时文件、编辑器备份等）
⚠️ 坑点：填错格式会导致整条规则失效。不要加路径前缀（如 src/config/*.json 不行），只写文件名或简单通配符；大小写敏感，.ENV 和 .env 得分开写。
WebStorm 的“忽略”本质是控制索引与部署行为，不是隐藏文件。真正容易被绕过去的点，是混淆了 Git 忽略、IDE 索引忽略、Deployment 排除这三层逻辑——它们互不感知，各管一摊。
