python无传统头文件，但可通过四种方式模拟：1. 用__all__控制模块公开接口；2. 创建常量/配置模块；3. 利用__init__.py聚合包级接口；4. 集中管理类型定义。

Python 没有传统意义上的“头文件”（如 C/c++ 中的 .h 文件），它不通过头文件声明函数、类或变量。但你可能想实现类似目的：比如统一管理常量、配置、类型定义、公共工具函数，或为模块提供清晰的公共接口。下面几种常见做法，能帮你达到“头文件”的效果：

1. 用 __all__ 控制模块公开接口

这是最接近“头文件声明作用”的方式——明确告诉使用者哪些名称是该模块推荐导出的。

在 mylib.py 中：

# mylib.py PI = 3.14159 MAX_RETRY = 3 def helper_func(): ... def _internal_helper(): ...  # 下划线开头，约定为私有 
all = ['PI', 'MAX_RETRY', 'helper_func']  # 只有这些会被 from mylib import * 加载

这样别人执行 from mylib import * 时，不会意外导入 _internal_helper；ide 和静态检查工具（如 mypy）也能据此推断公共 API。

立即学习“Python免费学习笔记（深入）”；

2. 创建纯配置/常量模块（类似 C 的 constants.h）

新建一个 constants.py 或 config.py，只放不可变定义：

# constants.py ENV = "production" DB_TIMEOUT = 30 STATUS_OK = 0 STATUS_ERROR = 1 SUPPORTED_FORMATS = ("json", "xml", "yaml")

其他模块直接导入使用：from constants import DB_TIMEOUT, STATUS_OK。语义清晰，便于集中维护和类型提示。

3. 使用 __init__.py 聚合子模块接口（包级“头文件”）

对于较复杂的包（如 myproject/），可在其 __init__.py 中整理并导出关键内容：

# myproject/__init__.py from .core import run, validate from .models import User, Post from .utils import format_date, retry 
提供简洁入口
all = ["run", "validate", "User", "Post", "format_date", "retry"]

使用者只需 import myproject 或 from myproject import User, run，无需关心内部模块结构——这正是大型库（如 requests、numpy）常用的“门面模式”。

4. 类型定义集中管理（配合 type hints）

在 types.py 中定义常用类型别名或 TypedDict：

# types.py from typing import TypedDict, List, Optional 
class UserInfo(TypedDict): name: str age: int tags: List[str]
UserID = str Timestamp = float

然后在业务模块中复用：from types import UserInfo, UserID。既提升可读性，也利于 mypy 检查。

Python 不需要头文件，但通过合理组织模块、善用 __all__、__init__.py 和专用常量/类型模块，完全可以实现更安全、更易维护、IDE 更友好的“接口声明”效果。