Pandas1.4.2中read_csv传StringIO触发PyCharm检查警告如何修复

使用Pandas 1.4.2版本时，编写从HTTP响应读取CSV数据的代码如下：

response: requests.Response = session.get(url="...")
data: pandas.DataFrame = pandas.read_csv(io.StringIO(response.content.decode("utf-8")), skiprows=2)

在PyCharm中执行Code Inspection时，会触发如下类型警告：

Expected type 'str | PathLike[str] | ReadCsvBuffer[bytes] | ReadCsvBuffer[str]', got 'StringIO' instead

要求在不抑制警告的前提下修改代码，消除该提示。

该警告的本质是PyCharm绑定的Pandas类型存根，没有将io.StringIO直接识别为符合ReadCsvBuffer[str]协议的类型，有两种可行修改方式，优先推荐第一种方案：

• 方案1（最简洁，无额外依赖）：去掉手动UTF-8解码和StringIO包装逻辑，改用io.BytesIO包装响应的原始字节内容，在read_csv参数中显式指定编码为utf-8，交给Pandas内部完成解码。io.BytesIO会被类型检查器正确识别为匹配的ReadCsvBuffer[bytes]类型，不会触发警告，同时减少了一次手动字符串拷贝，性能更好。
  修改后代码：

  response: requests.Response = session.get(url="...")
  data: pandas.DataFrame = pandas.read_csv(
      io.BytesIO(response.content),
      skiprows=2,
      encoding="utf-8"
  )
  

• 方案2（保留字符串缓冲区逻辑）：如果业务场景必须使用字符串形式的缓冲区，可以显式将缓冲区对象标注为Pandas定义的ReadCsvBuffer[str]类型，让类型检查器确认其符合参数协议。注意该方法需要导入Pandas的内部类型定义，版本兼容性略差。
  修改后代码：

  from pandas._typing import ReadCsvBuffer
  
  response: requests.Response = session.get(url="...")
  csv_buffer: ReadCsvBuffer[str] = io.StringIO(response.content.decode("utf-8"))
  data: pandas.DataFrame = pandas.read_csv(csv_buffer, skiprows=2)
  

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