Python 3.9.5如何让函数仅接受字符串参数并抛出TypeError？

为什么当前代码不生效 #

Python的类型注解（比如:str）仅作为静态提示，运行时不会自动验证参数类型。所以即使传入整数123，函数依然会执行并返回该值，不会抛出错误。

实现强制类型检查的方法 #

方法1：手动添加类型检查逻辑 #

在函数开头用isinstance判断参数类型，不符合时抛出TypeError，这是最直接的解决方案：

def fun(string: str):
    if not isinstance(string, str):
        raise TypeError("参数必须为字符串类型")
    return string

测试效果：

>>> fun(123)
TypeError: 参数必须为字符串类型
>>> fun("hello")
'hello'

方法2：使用assert语句（适合调试场景） #

如果仅在调试阶段需要类型检查，可以用assert，注意生产环境下用python -O运行时会跳过断言：

def fun(string: str):
    assert isinstance(string, str), "参数必须为字符串类型"
    return string

方法3：结合typing模块规范类型约束 #

用TypeVar定义严格的字符串类型，配合静态类型检查工具（如mypy）做静态校验，同时保留运行时检查：

from typing import TypeVar

StrType = TypeVar('StrType', bound=str)

def fun(string: StrType) -> StrType:
    if not isinstance(string, str):
        raise TypeError("参数必须为字符串类型")
    return string

补充说明 #

如果需要全局的运行时类型校验，可以考虑第三方库（如pydantic），但单个函数的需求下，手动添加isinstance判断是最轻量高效的方案。

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