Python模块是单个.py文件,包是含__init__.py的目录;import按内置模块、当前脚本目录、sys.path顺序查找;推荐绝对导入,虚拟环境解决依赖冲突。
Python 的模块和包管理核心在于理解 import 机制如何工作,以及依赖如何被定位、加载和解析。关键不在于记住所有路径规则,而在于掌握 Python 解释器查找模块的逻辑链条,以及如何主动干预这个过程。
模块是单个 .py 文件,是可导入的最小代码单元;包是包含 __init__.py(可以为空)的目录,用于组织多个模块并支持嵌套导入。没有 __init__.py 的目录只是普通文件夹,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 背后的真实路径行为,比死记语法更重要。真正可靠的项目结构,永远建立在清晰的路径控制和环境隔离之上。