Python 模块是单个。py 文件,包是含__init__.py 的目录;import 按内置模块、当前脚本目录、sys.path 顺序查找;推荐绝对导入,虚拟环境解决依赖冲突。

Python 的模块和包管理核心在于理解 import 机制如何工作,以及依赖如何被定位、加载和解析。关键不在于记住所有路径规则,而在于掌握 Python 解释器查找模块的逻辑链条,以及如何主动干预这个过程。
模块 vs 包:本质 区别 在哪
模块是单个 .py 文件,是可导入的最小代码单元;包是包含 __init__.py(可以为空)的目录,用于组织多个模块并支持嵌套导入。没有 __init__.py 的目录只是普通文件夹,Python 不会将其视为包。
常见误区:以为只要目录结构对就能 import。实际上,即使结构正确,如果该目录不在 Python 的搜索路径中,导入仍会失败。
import 是怎么找到模块的
Python 按固定顺序在以下位置查找模块:
立即学习“Python 免费学习笔记(深入)”;
- 内置模块(如
sys、os),优先级最高 - 当前脚本所在目录(即
__file__所在路径) -
sys.path列表中的路径,包括:
– 用户通过PYTHONPATH环境变量 添加的路径
– 安装的第三方包路径(如site-packages)
– 标准库 路径
你可以随时查看当前路径:import sys; print(sys.path)。修改 sys.path 能临时生效,但不推荐用于生产环境——应使用标准安装或 虚拟环境 管理依赖。
相对导入与绝对导入怎么选
在包内部,用点号(.)开头的是相对导入,只在包内有效,且必须在模块作为包的一部分被导入时才能使用(例如通过 python -m mypackage.mymodule)。直接运行 python mypackage/mymodule.py 会导致 ImportError: attempted relative import with no known parent package。
绝对导入更清晰、更安全,推荐始终优先使用:
- ✅
from mypackage.utils import helper - ❌
from .utils import helper(除非明确需要封装且控制入口方式)
相对导入适合大型包内部重构,避免硬 编码 顶层包名,但代价是可读性下降和执行方式受限。
依赖冲突与版本管理怎么办
不同项目可能依赖同一库的不同版本,系统级安装会导致冲突。解决方案是隔离环境:
- 用
venv创建轻量虚拟环境:python -m venv myenv,然后激活并安装依赖 - 用
pip list查看已安装包,pip show requests查看具体版本和依赖树 - 用
pip freeze > requirements.txt锁定当前环境依赖,便于复现 - 用
pip install -r requirements.txt一键安装全部依赖
注意:pip install 默认安装最新兼容版本;如需指定版本,写成 requests==2.31.0 或 django>=4.2,。
不复杂但容易忽略。理解 import 背后的真实路径行为,比死记语法更重要。真正可靠的项目结构,永远建立在清晰的路径控制和环境隔离之上。