Python Type Hints



Python เป็นภาษาที่ไม่บังคับชนิดข้อมูล (dynamic typing) ตัวแปรหนึ่งเก็บ int แล้วเปลี่ยนไปเก็บ string ก็ได้ ความยืดหยุ่นนี้ดีตอนเขียนเร็ว ๆ แต่พอโปรเจกต์ใหญ่ขึ้นจะเริ่มมีบั๊กแบบ “ส่งค่าผิดชนิดเข้าฟังก์ชัน” Type hints คือการเขียนบอกว่าตัวแปร/พารามิเตอร์ควรเป็นชนิดอะไร

Type hints ไม่ได้บังคับตอนรัน

จุดสำคัญที่ต้องเข้าใจก่อน: Python ไม่ตรวจ type hints ตอนรันโปรแกรม มันเป็นแค่คำอธิบาย

def greet(name: str) -> str:
    return "สวัสดี " + name

print(greet(123))   # ยังรัน! แล้ว error ตอน + เพราะ 123 ไม่ใช่ str

ประโยชน์มาจาก เครื่องมือ — editor (VS Code, PyCharm) เตือนตอนพิมพ์ และ type checker อย่าง mypy ตรวจทั้งโปรเจกต์ก่อนรัน

พื้นฐาน: พารามิเตอร์และค่าคืน

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


def full_name(first: str, last: str) -> str:
    return f"{first} {last}"


def is_adult(age: int) -> bool:
    return age >= 18


def log(message: str) -> None:      # None = ไม่คืนค่า
    print(message)

-> ตามด้วยชนิดของค่าที่ฟังก์ชันคืน

ตัวแปร

count: int = 0
name: str = "สมชาย"
price: float = 45.0
active: bool = True

ส่วนใหญ่ไม่จำเป็น เพราะ editor เดาชนิดจากค่าได้อยู่แล้ว ใส่เมื่อค่าเริ่มต้นไม่ชัดเจน

คอลเลกชัน

Python 3.9+ ใช้ชนิด built-in ได้เลย

names: list[str] = ["สมชาย", "สมหญิง"]
scores: dict[str, int] = {"สมชาย": 85}
point: tuple[int, int] = (3, 4)
tags: set[str] = {"python", "tutorial"}


def average(numbers: list[float]) -> float:
    return sum(numbers) / len(numbers)


def count_words(text: str) -> dict[str, int]:
    result: dict[str, int] = {}
    for word in text.split():
        result[word] = result.get(word, 0) + 1
    return result

Optional และ None

ถ้าค่าอาจเป็น None ได้ ใช้ | None (Python 3.10+)

def find_user(user_id: int) -> str | None:
    users = {1: "สมชาย", 2: "สมหญิง"}
    return users.get(user_id)      # อาจได้ None


result = find_user(5)
if result is not None:
    print(result.upper())          # editor รู้ว่าตรงนี้เป็น str แน่

พารามิเตอร์ที่มี default เป็น None

def create_post(title: str, tags: list[str] | None = None) -> dict:
    if tags is None:
        tags = []
    return {"title": title, "tags": tags}

Union: หลายชนิดที่ยอมรับได้

def to_int(value: int | str) -> int:
    return int(value)


print(to_int(5))      # 5
print(to_int("10"))   # 10

typing: เครื่องมือเพิ่มเติม

from typing import Callable, Any


# ฟังก์ชันที่รับฟังก์ชันมาเป็นพารามิเตอร์
def apply_twice(func: Callable[[int], int], value: int) -> int:
    return func(func(value))


print(apply_twice(lambda x: x + 3, 10))   # 16


# Any = ชนิดอะไรก็ได้ (ใช้เท่าที่จำเป็น มันปิดการตรวจ)
def process(data: Any) -> None:
    ...

Type alias: ตั้งชื่อชนิดที่ซับซ้อน

Matrix = list[list[float]]
UserId = int


def transpose(m: Matrix) -> Matrix:
    return [list(row) for row in zip(*m)]

กับ dataclass

type hints เป็นส่วนบังคับของ dataclass อยู่แล้ว

from dataclasses import dataclass


@dataclass
class Product:
    name: str
    price: float
    stock: int = 0

ตรวจด้วย mypy

สองคำสั่งนี้พิมพ์ใน เทอร์มินัล ไม่ใช่ใน Python shell

pip install mypy
mypy myscript.py

ตัวอย่างโค้ดที่ mypy จับได้

def greet(name: str) -> str:
    return "สวัสดี " + name

greet(123)
error: Argument 1 to "greet" has incompatible type "int"; expected "str"

รันครั้งเดียวเจอบั๊กชนิดผิดทั้งโปรเจกต์ โดยไม่ต้องรันโปรแกรมจริง

ควรใส่แค่ไหน

  • ใส่: พารามิเตอร์และค่าคืนของฟังก์ชันที่คนอื่นเรียกใช้, dataclass, โค้ดที่อยู่นาน
  • ไม่จำเป็น: ตัวแปรท้องถิ่นที่ค่าชัดเจน, สคริปต์สั้น ๆ ใช้ครั้งเดียว
  • อย่าฝืนใส่จนโค้ดรก ถ้าชนิดซับซ้อนเกินอธิบาย อาจเป็นสัญญาณว่าควรออกแบบใหม่

เช็คความเข้าใจก่อนข้ามบท

  • ใส่ type hint ให้ parameter และค่าที่ return ได้
  • เข้าใจว่า type hints ช่วยเครื่องมือและคนอ่าน แต่ไม่บังคับชนิดตอนรันตามปกติ
  • ลองเพิ่ม type hints ให้ฟังก์ชันในโปรเจกต์ก่อนหน้า แล้วรัน mypy ถ้ามีติดตั้ง

สรุป

  • Type hints เป็นคำอธิบาย ไม่บังคับตอนรัน แต่ editor และ mypy ใช้จับบั๊ก
  • def f(x: int) -> str: ระบุชนิดพารามิเตอร์และค่าคืน
  • list[str], dict[str, int] สำหรับคอลเลกชัน; X | None สำหรับค่าที่อาจเป็น None
  • ใส่ที่ขอบเขต (ฟังก์ชัน public, dataclass) เป็นหลัก

บทถัดไปว่าด้วยมาตรฐานการเขียนโค้ด PEP 8