Python模块的name属性如何由导入方式决定？

发布日期： 2026-01-01 阅读量： 作者： 心靈之曲

python中模块的`__name__`值由其在`sys.path`中的**解析路径**和**包层级结构**共同决定，而非源文件物理位置；不同导入方式（绝对/相对、路径修改前后）会导致同一.py文件被加载为多个独立模块，拥有不同的`__name__`。

在Python中，__name__不是静态绑定到源文件的“身份证”，而是模块对象在sys.modules字典中的键名——这个键名由Python导入系统根据当前sys.path、执行上下文（如是否作为包成员被导入）以及导入语句的语法共同推导得出。

核心规则：name = 导入路径的完全限定名（Fully Qualified Name）

当模块以 from test.a import base 方式导入时，Python将其注册为 sys.modules['test.a.base']，因此 base.__name__ == 'test.a.base'；
当通过修改sys.path使test/a/目录被当作顶层包（即与test/同级）并执行 from a import base 时，它被注册为 sys.modules['a.base']，故 base.__name__ == 'a.base'；
关键点：即使a/base.py是同一物理文件，只要导入路径不同，Python就视为两个独立模块，并分别创建两个module对象，各自拥有不同的__name__、全局命名空间和状态（如模块级变量、已执行的print等）。

实例验证（基于你的目录结构）

假设运行 python main.py（main.py位于test同级），默认sys.path[0]为main.py所在目录，其中仅test/可被识别为包：

# main.py
import test  # 触发 method1 行为

此时：

from .a import * → 解析为 test.a → base.py 的 __name__ 是 'test.a.base'
from test.b.b1 import * → 同样走 test 包路径 → base.py 仍为 'test.a.base'

而当你在 test/__init__.py 中执行：

import sys
import os
sys.path.append(os.path.dirname(__file__) + "/./")  # 等价于添加当前目录（即 test/ 父目录）

你实际上将 test 的父目录加入了sys.path，使得原test/a/目录现在可被直接识别为顶层包a/（因该目录含__init__.py）。此时：

from a import * → Python找到/a/__init__.py → base.py 被加载为 'a.base'
但 from test.a import base 仍存在且优先命中已缓存的 'test.a.base'（因test仍在sys.path中且更早）

⚠️ 注意：这会导致同一.py文件被加载两次——一次为'a.base'，一次为'test.a.base'，二者互不影响。例如对base.py中某个全局变量的修改，不会反映在另一个模块实例中。

✅ 正确实践建议

避免随意修改sys.path：它破坏模块唯一性，引发难以调试的状态不一致问题；
统一使用绝对导入：明确指定完整包路径（如from test.a.base import xxx），提升可读性与可维护性；
理解__name__的动态本质：它反映的是“如何被导入”，而非“文件在哪里”。可通过以下代码实时观察：

# 在 base.py 中添加
import sys
print(f"Base.py loaded as {__name__}")
print(f"Available in sys.modules: {list(k for k in sys.modules.keys() if 'base' in k)}")

启动脚本应置于包外：main.py 不应位于test/内，避免触发__main__与包内模块名冲突（如__name__ == '__main__' vs 'test.main'）。

总之，__name__是Python导入机制的产物，其值严格取决于模块被发现和加载的路径上下文。掌握这一原理，是写出健壮、可预测的Python包结构的关键基础。

上一篇: php后缀怎么变mp4能播放_让php伪装mp4正常播放的技

下一篇: Win11怎么设置任务栏大小_Windows11注册表修改T

Python模块的__name__属性如何由导入方式决定？

随便看看

南昌壹佳企网络通信有限公司

Python模块的name属性如何由导入方式决定？