Python 包、模块、导入规则

首先:在python中文件夹名不等于包名,文件夹中直接包含__init__.py文件的文件夹才是包,包的核心标识是 __init__.py。

其次:直接运行文件时,仅绝对导入(也就是无 .)生效,相对导入(也就是有 .)必报错;因为直接运行文件的目录就是root目录 放在 sys.path中的,如果有相对引用,就会报错。要使用绝对路径。比如a,b是同一个路径下的,运行a, 那么a的路径就是 root,被保存 在sys.path中,如果a中导入b中的方法,直接使用绝对路径 from b import B ,就能找到root+b的绝对路径,而不要再添加一个. 号了。如果路径格式如下:

p

|

-------p1

| |

| --------a.py

--------p2

|

-------b.py

python 复制代码
# p/p2/b.py
class B:
    def __init__(self):
        print("我是p2/b.py中的B类")
python 复制代码
# p/p1/a.py
import sys
from pathlib import Path

# 关键:把根目录p/加入sys.path
# Path(__file__) 是a.py的路径 → parent是p1/ → parent.parent是p/
ROOT_PATH = Path(__file__).parent.parent
sys.path.append(str(ROOT_PATH))

# 现在可以用绝对导入p2.b中的B类 因为p/已经在sys.path中了,可以直接看到p2.b
from p2.b import B

if __name__ == "__main__":
    b = B()  # 运行后输出:我是p2/b.py中的B类

其三:相对引用格式: .a 表示当前路径下的a文件,..a 表示上一级路径下的a文件,...a 表示上上一级的a文件。相对引用只能在 sys.path目录之内,不能跨过添加到sys.path的ROOT。

其四:当前运行的文件a, 系统会自动将当前文件路径添加到 sys.path中,Path(file) 是a.py的路径 → parent是p1/ → parent.parent是p/。

其五:还可以将深层的函数向上导出,从而简化导入路径。

在p/p2/init.py中

python 复制代码
#p/p2/__init__.py
from .b import B
__all__=['B']

在p/init.py中

python 复制代码
#p/__init__.py
from .p2 import B
__all__=['B']

这样外部就可以直接用 from p import B了

p

|

-------p1

| |

| --------a.py

--------p2

| |

| -------b.py

|

c.py

小结:

  • 包的本质 :带 __init__.py 的文件夹才是规范的包(框架开发必加),包内用相对导入(.xxx),外部用绝对导入;
  • sys.path 是核心 :Python 只从 sys.path 里找模块,直接运行文件时,文件所在目录会自动加入 sys.path,跨目录导入需手动加根目录;
  • 简化导入的技巧 :通过多层 __init__.py 逐级导出模块(如 YOLO 的 from ultralytics import YOLO),无需写深层路径;
  • 运行规范 :包内模块只做定义,可执行逻辑放 tools/ 下的入口脚本,避免直接运行包内文件导致相对导入报错。
相关推荐
CS_Zero1 小时前
DeepSeek V4.1 Flash 1017 (Batch) 新手极速上手指南
开发语言·batch·deepseek
山楂树の1 小时前
Java 字符串高效处理:StringBuilder、StringBuffer、StringJoiner
java·开发语言
Risehuxyc1 小时前
C# 发展历史
开发语言·c#
M--Y1 小时前
LangGraph 架构基石:持久化与运行控制
python·langchain·大模型·llm·持久化·langgraph
用户019027581612 小时前
新浪财经 / 东方财富股票接口不稳、被限?稳定替代方案
python
七夜zippoe2 小时前
Nexent 知识库:调优靠 Chunk 与重排
开发语言·python·ai智能体·nexent·知识库与rag
kyle~3 小时前
C# --- 反射
开发语言·c#
soso19683 小时前
低功耗设计与BMS开发指南
c语言·开发语言·汇编
承渊政道4 小时前
【Python编程—从入门到实践】(用户账户:给Django网站装上登录系统,让每个人拥有自己的学习笔记)
python·学习·pycharm·django
Risehuxyc5 小时前
来自PHP项目devnexen的回信
开发语言·php