python __init__.py的意义与使用

1. 基本规则

情况1：__init__.py 中已导入

python

# project/input/__init__.py
from .file_input import FileInput    # 在这里导入

# project/main.py
# ✅ 可以直接使用，不需要再写 from . import
from project.input import FileInput  # 简洁！

情况2：__init__.py 中未导入

python

# project/input/__init__.py
# 空文件或未导入 FileInput

# project/main.py
# ❌ 这样会报错
from project.input import FileInput  # ImportError!

# ✅ 必须写完整路径
from project.input.file_input import FileInput

2. 完整示例对比

不好的设计（每个文件都要写完整导入）

python

# project/input/__init__.py
# 空文件

# project/main.py
from project.input.file_input import FileInput
from project.input.cli_input import CLIInput
from project.input.api_input import APIInput

# project/processor/__init__.py  
# 空文件

# project/main.py（继续）
from project.processor.data_processor import DataProcessor
from project.processor.batch_processor import BatchProcessor

好的设计 （利用 __init__.py 简化）

python

# project/input/__init__.py
from .file_input import FileInput
from .cli_input import CLIInput  
from .api_input import APIInput
__all__ = ['FileInput', 'CLIInput', 'APIInput']

# project/processor/__init__.py
from .data_processor import DataProcessor
from .batch_processor import BatchProcessor
__all__ = ['DataProcessor', 'BatchProcessor']

# project/__init__.py
from .input import FileInput, CLIInput, APIInput
from .processor import DataProcessor, BatchProcessor
__all__ = ['FileInput', 'CLIInput', 'APIInput', 
           'DataProcessor', 'BatchProcessor']

# project/main.py
# ✅ 非常简洁，一目了然
from project import (
    FileInput,      # 来自 input 模块
    CLIInput,       # 来自 input 模块  
    DataProcessor,  # 来自 processor 模块
    BatchProcessor  # 来自 processor 模块
)