`coordinate_to_tuple()` 不支持带 `$` 的绝对地址（如 `'$a$2'`）；应改用 `range_boundaries()` 或组合 `coordinate_from_string()` 与 `column_index_from_string()` 来安全解析。
在使用 OpenPyXL 处理 Excel 单元格坐标时，开发者常期望 coordinate_to_tuple() 能统一支持相对地址（如 'A2'）和绝对地址（如 '$A$2'）。但该函数设计初衷是高性能解析工作表内部引用——它假设输入为标准相对格式，因此遇到 $ 符号会因正则匹配失败或字典键缺失（如 KeyError: '$A$'）而抛出异常。
✅ 推荐方案：range_boundaries()
这是 OpenPyXL 官方推荐、语义清晰且健壮的替代方式：
from openpyxl.utils.cell import range_boundaries
# 支持单个绝对单元格、区域、混合格式
coords = range_boundaries('$A$2') # 返回 (1, 1, 1, 1) → (min_col, min_row, max_col, max_row)
row, col = coords[1], coords[0] # → (1, 1)，对应第1行第1列（A1索引）
# 同样适用于区域（如 '$B$3:$D$5'）或相对地址（'C4'）
print(range_boundaries('C4')) # (3, 4, 3, 4)
print(range_boundaries('$B$3:$D$5')) # (2, 3, 4, 5)⚠️ 注意：range_boundaries() 返回四元组 (min_col, min_row, max_col, max_row)，对单个单元格而言，前后行列值相同，取 [0] 和 [1] 即可获得列号与行号（均为 1-based 整数）。
? 备选方案：显式解析（更直观，适合教学或简单场景）
若需明确拆解逻辑，可组合两个工具函数：
from openpyxl.utils.cell import coordinate_from_string, column_index_from_string
def absolute_coordinate_to_tuple(coord: str) -> tuple[int, int]:
col_str, row_num = coordinate_from_string(coord) # e.g., ('$A$', 2) or ('A', 2)
col_idx = column_index_from_string(col_str.strip('$')) # 去除可能的 $ 后转换
return (row_num, col_idx)
print(absolute_coordinate_to_tuple('$A$2')) # (2, 1)
print(absolute_coordinate_to_tuple('Z10')) # (10, 26)❌ 不推荐的“快捷”写法
如 coordinate_to_tuple(coord.replace('$', '')) 虽能运行，但存在隐患：若地址本身含 $（如命名区域引用或公式中的特殊语法），盲目替换可能导致误解析；且违背 API 设计意图，降低代码可维护性。
? 总结
- coordinate_to_tuple() 是底层优化函数，仅适用于相对地址；
- range_boundaries() 是面向用户的安全通用接口，天然兼容绝对/相对/区域地址，应作为首选；
- 所有坐标解析结果均采用 1-based 索引（行号、列号从 1 开始），与 Excel UI 一致；
- 避免字符串手动清洗（如 replace('$', '')），优先使用 OpenPyXL 提供的语义化工具函数。
