解决openpyxl中'_WorkbookChild'无'max_row'属性的mypy警告

问题重现 #

代码示例：

from openpyxl import load_workbook

wb = load_workbook("input.xlsx")
ws = wb.active
print(ws.max_row)

mypy报错：

test.py:6: error: "_WorkbookChild" has no attribute "max_row" [attr-defined]

原因分析 #

openpyxl的类型定义中，Workbook.active的返回类型被标注为_WorkbookChild——这是Worksheet和Chart的父类，但只有Worksheet拥有max_row属性。mypy无法静态推断wb.active确实是Worksheet实例，因此抛出错误。

解决方案 #

1. 使用类型断言（cast） #

通过typing.cast明确告诉mypy变量的具体类型：

from openpyxl import load_workbook
from openpyxl.worksheet.worksheet import Worksheet
from typing import cast

wb = load_workbook("input.xlsx")
ws = cast(Worksheet, wb.active)
print(ws.max_row)

2. 添加明确的类型注解 #

直接给变量指定Worksheet类型，让mypy识别具体类型：

from openpyxl import load_workbook
from openpyxl.worksheet.worksheet import Worksheet

wb = load_workbook("input.xlsx")
ws: Worksheet = wb.active
print(ws.max_row)

3. 安装官方类型存根 #

openpyxl自带的类型注解可能不够完善，安装第三方类型存根包可以解决这类问题：

pip install types-openpyxl

安装后，mypy会使用更准确的类型定义，无需额外修改代码即可识别wb.active为Worksheet类型。

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