PyCharm环境下gspread的sh.share方法未出现在代码补全选项列表

PyCharm补全列表找不到.share()不是版本移除、也不是安装错误，是静态类型推断的识别问题，方法本身可以正常调用。

核心原因 #

• gspread的Spreadsheet类的权限相关方法（包括share）是通过动态混入（mixin）方式挂载的，不是直接硬编码在类的初始定义里，PyCharm的静态索引扫描不到这类动态注入的方法，就不会出现在下拉补全列表里。
• 你已经能正常读写Google Drive上的表格，说明gspread安装、API鉴权配置全是正常的，不需要重装库、切换Python版本。

解决方式 #

• 直接忽略补全提示运行代码即可，官方示例的调用逻辑完全有效：

  # sh为你已获取的Spreadsheet实例，直接调用即可触发共享
  sh.share('blah@blah.co.nz', perm_type='user', role='writer')
  

  执行后不会报AttributeError，会正常给目标邮箱发送共享通知。
• 如果需要补全提示，给实例添加明确的类型注解即可让PyCharm识别到所有可用方法：

  from gspread import Spreadsheet  # 导入类型类
  
  # 打开表格时标注变量类型
  sh: Spreadsheet = client.open("你的表格名称")
  

  标注后再输入sh.就能在补全列表找到share方法。
• 加了注解还是没有补全的话，清除PyCharm缓存重建索引即可：依次点击菜单栏 File -> Invalidate Caches...，勾选清除文件缓存选项后重启IDE，等索引扫描完成就恢复正常。

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