为何Python类型提示指定cfg为dict，传入str却未报错且输出异常？

嘿，这个问题其实是Python类型提示的常见误区，咱们一步步理清楚：

1. Python的类型标注是「提示」而非「强制约束」 #

你给参数cfg标注了: dict，但Python解释器默认在运行时完全不检查类型——这是动态语言的特性，类型标注只是给开发者和静态检查工具（比如mypy、pyright）看的，不是用来限制运行时传入的参数类型。所以你传字符串进去，函数不会自动报错，照样执行。

2. 你的输出大概率是两次调用的结果 #

看你给出的输出：

<class 'dict'> {'size': '14 pt', 'bold': True, 'font_family': 'xxx'} <class 'str'> <<paragraph.basic>>

这应该是两次调用函数的打印结果拼在了一起：第一次你传入了符合要求的dict类型参数，第二次传入了str类型的<<paragraph.basic>>。因为没有类型检查，第二次调用也顺利执行了，所以打印出了字符串的类型和内容。

如何让类型约束真正生效？ #

如果你希望在运行时强制检查参数类型，或者在编码阶段就发现问题，可以这么做：

• 运行时检查：在函数开头手动添加类型验证逻辑：

  def __to_oxml_json_p__(cfg: dict, content: list, panel_cfg: dict = None):
      # 手动校验参数类型
      if not isinstance(cfg, dict):
          raise TypeError(f"参数cfg必须是dict类型，实际传入了{type(cfg).__name__}")
      if not isinstance(content, list):
          raise TypeError(f"参数content必须是list类型，实际传入了{type(content).__name__}")
      print(type(cfg), cfg)
  

• 静态检查：使用mypy这类工具，在编码阶段就能发现类型不匹配的问题。安装后运行mypy your_script.py，它会自动提示你哪里传入了不符合标注的类型。

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