在 PyCharm 2023.1 中，右键点击 node_modules 目录并选择“Mark Directory as” > “Excluded”即可停止索引。适用于前端依赖导致 IDE 卡顿的 Python 项目，风险是该目录内代码将失去跳转和补全支持。
先说结论：通过标记目录为“Excluded”状态，PyCharm 会跳过该文件夹的索引构建，从而降低 CPU 和 IO 负载。
- 先定位：确认卡顿源于索引进程（右下角进度条长期显示 Indexing）。
- 先做：在项目视图中排除 node_modules 目录。
- 再验证：观察索引进度条是否快速消失且搜索不包含该目录文件。
快速处理思路
此操作主要在图形界面完成，无需命令行。核心动作是在项目结构设置中更改目录属性。如果项目频繁重建 node_modules，建议将排除配置纳入版本控制或脚本自动化。
为什么会这样
PyCharm 默认索引项目内所有文件以提供代码补全和搜索功能。node_modules 通常包含数万个小文件，索引这些文件会消耗大量 CPU 和磁盘 IO。排除目录后，IDE 不再解析该路径下的内容，直接减少索引工作量。公开资料中没有看到可靠的量化数据，但经验表明排除大型依赖目录能显著减少索引时间。
分步处理
- 打开项目视图：在 PyCharm 左侧 Project 工具窗口中找到 node_modules 文件夹。
- 执行排除操作：右键点击 node_modules 目录，选择
Mark Directory as>Excluded。 - 确认颜色变化：排除后的文件夹名称通常会变为橙色或带有排除图标，表示配置已生效。
- 替代方案：若右键菜单无选项，进入
File>Settings(macOS 为PyCharm>Settings) >Project>Project Structure，选中目录后点击顶部Excluded按钮。
怎么验证是否生效
观察右下角状态栏的索引进度条，排除后重新打开项目或触发索引时，进度条应快速完成不再长时间停留。使用 Double Shift 搜索文件时，输入 node_modules 内的文件名应无法搜到结果。检查 .idea/misc.xml 或项目配置文件，确认包含排除路径记录。
常见坑
- Git 忽略不等于 IDE 排除：仅在
.gitignore中配置不会阻止 PyCharm 索引，必须在 IDE 内单独设置。 - 误排除源码：确保只排除依赖目录，不要误将项目自身的
src或lib目录标记为排除，否则会导致代码无提示。 - 依赖更新后恢复：删除并重新安装 node_modules 后，排除状态通常会保留，但若重建项目结构需重新检查。
常见问题
排除后还能编辑 node_modules 里的文件吗
可以编辑，但没有代码补全和跳转支持。排除仅影响索引和搜索，不影响文件读写权限。
如何取消排除设置
右键点击已排除的橙色目录，选择 Mark Directory as > Cancel Exclusion 即可恢复索引。
这个设置会同步给团队成员吗
排除配置通常保存在 .idea 目录下的 XML 文件中，若该目录纳入版本控制，配置会同步；否则需每人单独设置。
参考来源
- JetBrains Official Documentation, Project Structure, https://www.jetbrains.com/help/pycharm/project-structure.html