Python 类型提示 (Type Hints)

大家好！今天我们来聊聊Python的类型提示。类型提示是Python中用来标注变量、参数和返回值的类型的一种方式。了解Typescript的朋友应该会很熟悉。有点类似于Typescript语言给Javascript加上了类型系统。虽然增加了代码编写的繁杂度，但好处也是显而易见。尤其在大型项目中。它可以帮助开发者更清晰地理解代码，提高代码的可读性。通过类型提示，IDE可以提供更好的代码补全和错误检查。类型提示还有助于团队协作，减少类型相关的错误。它支持静态类型检查工具如mypy，发现潜在问题。类型提示还可以用于文档化代码，方便维护和重构。

看下例子：在我们例子中，add函数标注了参数和返回值都是int类型。 greet函数则标注参数和返回值都是str。 process函数的参数是一个整数列表，返回值是None。 get_item函数展示了字典类型的参数和整数返回值。 flexible函数使用了Union类型，接受int或str类型。此外，Optional类型可表示可能为None的值，非常实用。 Generic范型类型允许定义更灵活和可重用的代码结构。

使用类型提示时需注意以下几点：首先，类型提示是可选的，运行时不会强制检查。其次，过度复杂的类型注解可能降低代码可读性。另外，类型提示需与实际代码行为一致，否则会误导。最后，旧版Python可能不支持某些高级类型功能。

希望这个简单的例子能帮助你理解Python的类型提示！

代码示例

from typing import List
from typing import Dict
from typing import Union
from typing import Optional
from typing import Generic
from typing import TypeVar

def add(a: int, b: int) -> int:
    return a + b

def greet(name: str) -> str:
    return f"Hi, {name}"

def process(data: List[int]) -> None:
    print(data)

def get_item(key: str, 
             d: Dict[str, int]) -> int:
    return d[key]

def flexible(x: Union[int, str]) -> str:
    return str(x)

def maybe_num(flag: bool) -> Optional[int]:
    return 5 if flag else None

T = TypeVar('T')
class Box(Generic[T]):
    def __init__(self, item: T):
        self.item = item
    
    def get_item(self) -> T:
        return self.item

num: int = add(5, 3)
msg: str = greet("Alice")
lst: List[int] = [1, 2, 3]
d: Dict[str, int] = {"a": 1}
val: int = get_item("a", d)
mix: str = flexible(10)
opt: Optional[int] = maybe_num(True)
box_int: Box[int] = Box[int](123)
box_str: Box[str] = Box[str]("text")

Python 类型提示 (Type Hints)

代码示例​

代码示例