在 Python 的異步編程世界中，os.path 模塊的同步文件操作函數常常讓我們陷入兩難境地：直接使用它們會阻塞事件循環，降低程序性能；但這些函數又如此方便實用。今天，我將帶你探索如何巧妙地將這些同步函數轉換為異步版本，讓你的異步程序既能享受高效的事件處理，又能無縫利用強大的文件操作功能。

一、問題背景：同步函數的異步困境

在異步編程中，直接調用同步函數可能會阻塞事件循環，從而影響程序的性能。例如，os.path.exists 是一個同步函數，用于檢查文件是否存在。如果在異步程序中直接調用它，可能會導致事件循環被阻塞，直到該函數執行完成。為了避免這種情況，我們可以將這些同步函數轉換為異步版本，使它們能夠在不阻塞事件循環的情況下運行。

二、解決方案：裝飾器 wrap 的魔法

為了將同步文件操作函數轉換為異步版本，我們可以使用 asyncio 模塊中的 run_in_executor 方法。這個方法允許我們在指定的執行器中運行同步函數，從而實現異步調用。以下是一個實現這一轉換的裝飾器 wrap：

import asyncio
from functools import partial, wraps
from os import path

1. 裝飾器 wrap 的實現

裝飾器 wrap 的作用是將一個同步函數包裝成一個異步函數。它使用 asyncio.get_running_loop().run_in_executor 方法在指定的執行器中運行同步函數，從而實現異步調用。

def wrap(func):@wraps(func)async def run(*args, loop=None, executor=None, **kwargs)