PyCharm执行‘update usage to reflect signature change’卡顿严重求助

一、先排查目录排除的有效性 #

• 确认涉事的数万文件目录，不仅在Settings > Project Structure中设为Excluded，还要在Settings > Build, Execution, Deployment > Compiler > Excludes里也添加排除——有时候仅排除索引不足以让PyCharm在签名分析时完全忽略该目录。
• 检查函数内部是否有动态指向该目录的代码（比如通过变量拼接路径），这类动态逻辑可能绕过目录排除规则，触发不必要的静态分析。可以把路径抽成常量，或者用# noinspection PyUnresolvedReferences注释标记，让PyCharm跳过对该部分的分析。

二、调整PyCharm性能设置 #

• 增加内存分配：找到PyCharm安装目录下的pycharm64.exe.vmoptions（Windows）或pycharm.vmoptions（Mac/Linux），修改-Xmx参数（比如从默认的-Xmx2048m改成-Xmx4096m，根据你的电脑内存调整，8G内存建议设4G，16G内存建议设8G），给PyCharm更多运行资源。
• 关闭非必要检查和插件：
  • 在Settings > Editor > Inspections里，暂时关闭和文件系统、路径解析相关的非核心检查项，完成签名更新后再恢复。
  • 在Settings > Plugins里禁用暂时用不到的第三方插件，减少后台运行负载。

三、替换自动更新为更高效的批量操作 #

既然手动用Find Usages只需要几分钟，可以换用更高效的批量替换方式：

• 用Find Usages定位所有函数调用，全选结果后点击「Replace All」，一次性完成替换，比逐个手动改快很多，同时避免自动更新时的全量分析开销。
• 如果调用分布在多个模块，可以分模块执行更新，比如先处理某个子目录下的引用，完成后再处理其他部分，缩小单次分析的范围。

四、关于是否是软件Bug #

这种情况大概率是PyCharm静态分析的性能缺陷：即使目录被排除索引，当函数内部涉及该目录操作且调用次数较多时，PyCharm在处理签名更新时可能仍会触发不必要的路径遍历或依赖分析，导致耗时剧增。
你可以在JetBrains官方的问题追踪平台搜索类似问题，若没有匹配项，可提交Bug报告，附上项目规模、函数调用次数、目录排除设置、电脑配置、PyCharm版本，以及自动更新和手动替换的耗时对比数据，帮助官方定位修复。

内容的提问来源于stack exchange，提问作者EMILIO