Python中__name__属性的作用与变化

golang学习网今天将给大家带来《Python 中的 __name__ 属性会根据模块是作为主程序运行还是被导入而发生变化。以下是详细解释：1. 模块作为主程序运行时当你直接运行一个 Python 文件（例如 script.py），这个文件会被当作主程序来执行，此时它的 __name__ 属性为 "__main__"。# script.py print(__name__)运行结果：__main__2. 模块被其他模块导入时当一个模块被其他模块导入时，其 __name__ 属性就是该模块的文件名（不带 .py 后缀）。例如，有一个模块 module.py，内容如下：# module.py print(__name__)然后在另一个文件中导入它：# main.py import module运行结果：module3. 使用 import 和 from import 的区别使用 import module 时，module.__name__ 是 "module"。使用 from module import func 时，module.__name__ 仍然是 "module"，因为模块本身并没有被重命名。4. 使用 __main__.py 时的情况如果你在一个目录中包含 `__》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

Python 模块的 `__name__` 由其**在 `sys.path` 中的解析路径**和**导入语句的命名空间上下文**共同决定，不同导入方式（如绝对/相对导入、路径修改）可能导致同一物理文件被加载为多个不同 `__name__` 的模块实例。

在 Python 中，__name__ 并非由文件路径直接决定，而是由 模块被导入时的“全限定名”（fully qualified name） 决定——这个名称反映的是 Python 解释器在 sys.path 中按顺序查找并解析出的包层级结构。关键原则如下：

✅ 核心规则：__name__ = 导入路径的逻辑命名

• 当执行 from test.a import base，Python 将 base.py 注册为模块 test.a.base，因此 base.__name__ == 'test.a.base'；
• 当执行 from a import base（前提是 a/ 目录在 sys.path 中且未作为子包存在），Python 将其视为顶层包，于是 base.__name__ == 'a.base'；
• 即使 a.base 和 test.a.base 指向同一物理文件，它们在 sys.modules 中是两个独立的模块对象，拥有不同的 __name__、独立的全局命名空间，甚至可能执行多次 print(__name__)。

? 验证：观察 sys.modules

你可以在任意位置插入以下调试代码：

import sys
print("Current modules containing 'base':")
for k in sorted(sys.modules.keys()):
    if 'base' in k:
        print(f"  {k} → {sys.modules[k]}")

在你的 method1（仅通过 test 包导入）中，只会看到 'test.a.base'；而在 method2（手动追加路径后）中，将同时存在 'test.a.base' 和 'a.base' —— 它们是两个完全隔离的模块实例。

⚠️ 危险后果：状态不一致

假设 base.py 定义了一个可变全局变量：

# test/a/base.py
counter = 0
print("Base.py loaded, __name__ =", __name__)

def inc():
    global counter
    counter += 1
    return counter

那么：

• from test.a import base 后调用 base.inc() 修改的是 test.a.base.counter；
• from a import base 后调用 base.inc() 修改的是 a.base.counter； 二者互不影响，极易引发隐蔽的逻辑错误。

? 为什么 sys.path.append(... + "/./") 是问题根源？

你添加的这行：

sys.path.append(os.path.dirname(os.path.abspath(__file__)) + "/./")

等价于将 test/ 的父目录（即 test 所在目录）再次加入 sys.path。但此时该目录下直接存在 a/ 和 b/ 子目录，Python 会将其识别为顶层包（而非 test 的子包），从而创建 a.base 这一新命名空间。

? 提示："/./" 是冗余写法，应简化为 os.path.dirname(...)；而 /.. 则可能重复添加父目录，无实际意义。

✅ 最佳实践：保持导入一致性

• 永远优先使用绝对导入（如 from test.a import base），明确依赖层级；
• 避免手动修改 sys.path 来“绕过”包结构，这破坏了 Python 的模块唯一性保证；
• 若需从包外运行模块，使用 -m 参数：python -m test.a.a1（此时 __name__ 为 'test.a.a1'，且不会重复加载）；
• 在 main.py 中统一通过 import test 或 from test import a, b 入口，禁止混合 from a import ...。

? 总结

理解 __name__ 的本质，就是理解 Python 的模块注册机制：它不是文件系统映射，而是 sys.path + 导入语法共同构建的逻辑命名空间注册表。尊重这一机制，才能写出可预测、可维护的 Python 包结构。

理论要掌握，实操不能落！以上关于《Python中__name__属性的作用与变化》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！