Pandas MultiIndex的names参数传[None,None]触发PyCharm警告如何处理

问题原因 #

• 该警告属于PyCharm的类型检测误报，不是代码逻辑问题。pandas的MultiIndex.from_tuples方法的names参数本身允许传入包含None的序列，None是合法的Hashable类型，完全符合参数要求，代码运行结果正常也验证了这一点。
• 触发误报的原因是PyCharm自带的pandas类型存根文件对names参数的类型校验规则写得不够严谨，误将包含None的列表判定为不符合Sequence[Hashable]要求。

消除警告的解决方案 #

方案1：替换列表为元组（最推荐） #

将names参数的传入值从列表改为元组，PyCharm对不可变序列的类型检测适配度更高，绝大多数情况下可以直接消除警告：

lst_of_tuples = [('A', 'X'), ('A', 'Y'), ('B', 'X'), ('B', 'Y')]
columns = pd.MultiIndex.from_tuples(lst_of_tuples, names=(None, None))

方案2：局部忽略类型警告 #

如果改完元组仍有警告，可以在对应代码行添加PyCharm的忽略注解，仅跳过这一行的类型检测，不影响其他代码的校验逻辑：

lst_of_tuples = [('A', 'X'), ('A', 'Y'), ('B', 'X'), ('B', 'Y')]
# noinspection PyTypeChecker
columns = pd.MultiIndex.from_tuples(lst_of_tuples, names=[None, None])

补充说明 #

现有代码完全符合pandas的官方使用规范，不需要修改逻辑，仅需要处理IDE的误报提示即可。

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