2025 最新 Python 參數檢查技巧

在 Python 中，函式的參數檢查是一個重要的主題。隨著 Python 語言的進步，從 2025 開始，使用 **type hints**（類型提示）和函式註解成為檢查參數的最佳實踐。這不僅能提高程式的可讀性，還能在開發過程中提供更好的錯誤檢查。

使用 type hints 進行參數檢查

類型提示允許開發者為函式的參數和返回值指定類型，這有助於靜態檢查工具（如 `mypy`）在開發過程中提前發現錯誤。以下是使用 type hints 的範例：

def my_function(x: int, y: int) -> int:
    return x + y

在這個範例中，我們明確指定 `x` 和 `y` 參數的類型為 `int`，並且函式返回值的類型也是 `int`。

使用 assert 進行值的檢查

雖然 type hints 提供了類型檢查的功能，但它並不會在運行時檢查參數的值。為了進行更深入的檢查，我們可以使用 `assert` 語句來驗證參數的值是否符合要求。例如：

def my_function(x: int, y: int) -> int:
    assert x > 0, "x 必須大於 0"
    assert y > 0, "y 必須大於 0"
    return x + y

這樣，在函式調用時，如果 `x` 或 `y` 的值不符合要求，就會引發錯誤，幫助我們快速定位問題。

實作範例：完整的參數檢查

以下是一個完整的範例，展示如何結合 type hints 和 assert 語句進行參數檢查：

def calculate_area(length: float, width: float) -> float:
    assert length > 0, "長度必須大於 0"
    assert width > 0, "寬度必須大於 0"
    return length * width

# 範例調用
try:
    area = calculate_area(5.0, 3.0)
    print(f"面積: {area}")
except AssertionError as e:
    print(e)

這個範例中，我們計算矩形的面積，同時檢查長度和寬度是否為正數。

延伸應用：使用裝飾器進行參數檢查

如果你想要更通用的解決方案，可以考慮使用裝飾器來進行參數檢查。裝飾器允許你在不修改函式本身的情況下添加額外的功能。以下是一個簡單的裝飾器範例：

from functools import wraps

def validate_positive(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        for arg in args:
            assert arg > 0, f"參數 {arg} 必須大於 0"
        return func(*args, **kwargs)
    return wrapper

@validate_positive
def add(x: int, y: int) -> int:
    return x + y

在這個範例中，`validate_positive` 裝飾器將檢查所有位置參數是否為正數。

總結

在 2025 年，Python 提供了多種方式來檢查函式的參數，包括使用 type hints、assert 語句和裝飾器。這些工具不僅提高了程式的健壯性，也使得程式的可讀性大大增強。隨著 Python 的不斷演進，學會這些最佳實踐將有助於提升你的開發技能。

如需進一步了解 Python 的各種技巧與實作，請參考 [vocus.cc 的 Python 教學文章](https://vocus.cc) 或 [miner.tw 的相關資源](https://miner.tw)。

Q&A（常見問題解答）

**Q1: Python 的 type hints 是什麼？**
A1: Type hints 是一種在 Python 函式中指定參數和返回值類型的方式，幫助提高程式的可讀性和靜態檢查的準確性。

**Q2: 如何檢查函式參數的值？**
A2: 可以使用 `assert` 語句檢查參數的值是否符合特定條件，若條件不滿足則會引發錯誤。

**Q3: 裝飾器如何運作？**
A3: 裝飾器是一種函式，允許你在不修改原有函式的情況下增加額外的檢查或功能，通常用於重複性任務的簡化。

—

Categorized in:

python

Tagged in: