Python 3.11+：兼容importlib与pathlib的文件资源类型注解选什么？

在Python 3.11及以上版本中，目前没有专门为Traversable和Path提供的内置联合类型，但可以通过以下几种方式简化类型注解：

• 使用os.PathLike[str]
  从importlib.resources.files返回的Traversable实例实际都实现了__fspath__方法，符合os.PathLike[str]的定义，而Path本身就是os.PathLike[str]的子类。用这个类型标注可以覆盖两种场景，运行时完全兼容。
  示例代码：

  from os import PathLike
  from pathlib import Path
  from importlib.resources.abc import Traversable
  
  def process_file(file_to_process: PathLike[str]) -> None:
      with open(file_to_process, 'r') as f:
          content = f.read()
          # 处理内容
  

  注意：部分类型检查器（如mypy）可能会因为Traversable的ABC未显式继承PathLike而发出警告，可通过添加# type: ignore注释忽略，或在Python 3.12+版本中使用importlib.resources.abc.Resource（它同时继承了Traversable和PathLike[str]），进一步提升类型兼容性。

• 复用自定义联合类型
  如果你介意类型检查器的警告，最稳妥的方式是定义一次简短的联合类型，之后在所有需要的地方复用：

  from typing import TypeAlias
  from importlib.resources.abc import Traversable
  from pathlib import Path
  
  FileResource: TypeAlias = Traversable | Path
  
  def process_file(file_to_process: FileResource) -> None:
      # 处理逻辑
  

  这种方式类型安全，且仅需定义一次，完全满足你的需求。

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