PyCharm索引第三方库是为了支持跨库跳转、代码补全和引用查找，但会因解析大量site-packages文件导致性能下降；可通过标记site-packages为Excluded目录来跳过索引，同时保持正常import和运行功能。
为什么PyCharm会索引第三方库？
PyCharm默认把项目中所有可访问的Python路径（包括venv、site-packages）都纳入索引范围，目的是支持跨库跳转、补全和引用查找。但site-packages里动辄几万个文件（比如torch或tensorflow），每个都要解析AST、提取符号——这不是“要不要用”，而是IDE在后台默默干的重活。
怎么让PyCharm跳过索引site-packages？
不能直接删或改解释器路径，得从索引策略上“绕开”：
- Settings → Project → Python Interpreter → 点右上角齿轮图标 → Show All… → 选中当前解释器 → 点右侧
…→ Show in Explorer，找到site-packages所在目录 - 回到PyCharm主界面，在Project工具窗右键该
site-packages文件夹 → Mark Directory as → Excluded - 确认右下角弹出提示“Indexing scheduled”后，等几秒，再手动触发
File > Reload project from disk（不是重启）
注意：Excluded后你仍能正常import和运行，只是失去对库源码的跳转/补全；如果真需要查某个库的实现（比如调试requests内部），临时取消Excluded即可。
venv被误标为Sources时的典型卡顿现象
常见错误操作：右键.venv或venv文件夹 → Mark Directory as → Sources Root。这会让PyCharm把整个虚拟环境当成“你的代码”，疯狂索引所有依赖包，CPU持续100%，右下角长时间显示Indexing… 12456 of 18932 files。
正确做法是：
- 右键
venv→ Mark Directory as → Excluded（不是Resources Root或Test Sources Root） - 检查
Project Structure（Ctrl+Alt+Shift+S）里是否还有其他非代码目录被设为Sources，比如data/、logs/、models/ - 若已误标，右键该目录 → Unmark as Sources Root，再重新
Excluded
误标Sources比内存不足更隐蔽——它不会报错，但索引量指数级增长，且每次Git切换分支都会触发全量重索引。
立即学习“Python免费学习笔记（深入）”；
索引慢还卡在“Parsing file…”？检查二进制/大文件
PyCharm遇到.pth、.so、.dll甚至超大.json（>10MB）时，会尝试解析并失败重试，日志里反复出现Parsing file xxx failed: Unsupported file type。这不是bug，是它在“努力”。
解决方式很直接：
- 把模型文件夹（
models/）、数据集（data/raw/）、打包产物（dist/）全部Excluded - 在
Settings → Editor → File Types里，把Registered Patterns中*.pth、*.h5、*.parquet等加到Ignore files and folders（用分号隔开） - 避免在项目根目录放
docker-compose.yml或package.json——它们会激活JS/CSS检查插件，间接拖慢Python索引线程
真正影响索引速度的，往往不是代码行数，而是那些你根本不想让它看的文件。
