0

0

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

心靈之曲

心靈之曲

发布时间:2026-01-01 16:46:24

|

518人浏览过

|

来源于php中文网

原创

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

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 中执行:

Poly.ai
Poly.ai

AI电话语音服务助手,接听电话并自动回复客户。

下载

立即学习Python免费学习笔记(深入)”;

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中某个全局变量的修改,不会反映在另一个模块实例中。

✅ 正确实践建议

  1. 避免随意修改sys.path:它破坏模块唯一性,引发难以调试的状态不一致问题;
  2. 统一使用绝对导入:明确指定完整包路径(如from test.a.base import xxx),提升可读性与可维护性;
  3. 理解__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)}")
  1. 启动脚本应置于包外:main.py 不应位于test/内,避免触发__main__与包内模块名冲突(如__name__ == '__main__' vs 'test.main')。

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

17

2026.02.03

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

87

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

105

2025.09.18

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

7

2026.03.04

AI安装教程大全
AI安装教程大全

2026最全AI工具安装教程专题:包含各版本AI绘图、AI视频、智能办公软件的本地化部署手册。全篇零基础友好,附带最新模型下载地址、一键安装脚本及常见报错修复方案。每日更新,收藏这一篇就够了,让AI安装不再报错!

12

2026.03.04

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

33

2026.03.03

C++高性能网络编程与Reactor模型实践
C++高性能网络编程与Reactor模型实践

本专题围绕 C++ 在高性能网络服务开发中的应用展开,深入讲解 Socket 编程、多路复用机制、Reactor 模型设计原理以及线程池协作策略。内容涵盖 epoll 实现机制、内存管理优化、连接管理策略与高并发场景下的性能调优方法。通过构建高并发网络服务器实战案例,帮助开发者掌握 C++ 在底层系统与网络通信领域的核心技术。

25

2026.03.03

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

77

2026.02.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.7万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号