PyCharm卡在“Indexing Python Dependencies”的根本原因是其反复解析site-packages中大量第三方包的源码或类型存根（如pyi文件、复杂__init__.py），叠加启用耗资源索引选项；常见诱因包括mypy/pylint实时检查、types-*包过多、venv路径误设为项目根目录，以及Pyright等插件触发冗余类型扫描。
PyCharm 为什么卡在“Indexing Python Dependencies”？
根本原因不是项目大，而是 PyCharm 在扫描 site-packages 时反复解析大量第三方包的源码或类型存根（尤其是带 pyi 文件或复杂 __init__.py 的包），同时又启用了耗资源的索引选项。常见诱因包括：装了 mypy、pylint 插件并开启实时检查；types-* 包过多；或 venv 路径被错误设为项目根目录而非子目录。
关闭不必要的依赖索引项
PyCharm 默认会索引所有 site-packages 下的源码和类型提示，但多数开发场景只需符号跳转，不需要完整语义分析。进入 Settings > Languages & Frameworks > Python > Interpreters，选中当前解释器，点击右侧齿轮图标 → Show All → 双击你的解释器 → 点击下方 Show Interpreter Paths，然后：
- 取消勾选
Include system site-packages（如果你没显式用它） - 手动删掉列表里非必需的路径，比如
dist-packages下的旧版本包、types-*包所在路径 - 对已知不需跳转的包（如
numpy、torch），右键 →Exclude
禁用插件级索引增强
某些插件会在后台额外触发依赖扫描，最典型的是 Mypy 和 Pyright（如果装了官方 Python 插件的预发布版）。检查 Settings > Plugins：
- 禁用
Mypy插件，改用终端命令手动运行 - 若启用
Pyright，进其设置关掉Enable type checking或切换为basic模式 - 避免安装
Python Type Checker类冗余插件
这些插件的实时类型推导会反复读取 site-packages 中的 pyi 文件，极易引发 I/O 阻塞。
立即学习“Python免费学习笔记（深入）”；
调整索引线程与缓存策略
PyCharm 的索引是单线程优先执行的，但可限制其资源占用，避免拖垮整个 IDE。编辑 Help > Edit Custom VM Options...，添加：
-Didea.max.intellisense.filesize=2500 -Didea.indexing.slow.operations.notification=false -Didea.is.internal=true
同时，在 Settings > Editor > General > Editor Tabs 中关闭 Enable preview tab——预览标签页会隐式触发额外文件解析。最后，定期清理：File > Invalidate Caches and Restart > Just Restart（不用选 “Clear” ，除非刚换过 Python 版本）。
真正卡死往往发生在 venv 目录结构异常或 pyproject.toml 里写了错误的 tool.poetry.dependencies 引用路径，这种问题不会报错，但会让索引陷入递归查找。遇到持续卡住，先检查 venv 是否干净、有无软链接指向系统 Python 路径。
