Python引用文件的核心是通过import语句使当前脚本访问其他模块的变量、函数或类,关键在于Python解释器如何通过sys.path查找模块,并正确组织__init__.py以支持包导入和相对导入。

Python 引用文件,核心是“让当前脚本能访问并使用另一个 Python 文件里的变量、函数或类”,这主要通过 import 语句实现。关键不在于“路径怎么写”,而在于Python 解释器如何找到那个文件(即模块搜索路径)。下面分几种常见情况说明:
同一目录下的文件直接 import
如果 a.py 和 b.py 在同一个文件夹里,想在 a.py 中用 b.py 里的函数:
- 确保 b.py 是合法的 Python 模块(比如不以数字开头、不含特殊符号)
- 在 a.py 里写:import b 或 from b import some_function
- 注意:不要加 .py 后缀,也不要用引号
子文件夹里的文件用点号导入(包方式)
如果 b.py 在子文件夹 utils/b.py,且该文件夹里有 __init__.py(可以为空),就构成了一个包:
- 在 a.py 中写:from utils import b 或 from utils.b import helper
- __init__.py 是必须的,否则 Python 不认为它是可导入的包
不在默认路径?手动加 sys.path
如果目标文件在任意位置(比如桌面、D:\mylib),Python 默认找不到,可以临时加路径:
立即学习“Python免费学习笔记(深入)”;
- 在 a.py 开头加上:
- import sys
- sys.path.append(r'D:\mylib') # 注意用原始字符串或双反斜杠
- 然后就能 import mymodule 了
- ⚠️ 这种方式只对当前运行有效,不推荐长期用于项目,适合临时调试
用相对导入(仅限包内,且需正确执行)
在包结构中,比如 pkg/a.py 想导入同级的 pkg/b.py:
- 写成:from . import b 或 from .b import func
- ⚠️ 必须用 python -m pkg.a 方式运行,不能直接 python pkg/a.py,否则报错 “attempted relative import with no known parent package”
基本上就这些。关键是理解 import 不是“读文本”,而是“加载模块对象”;路径问题本质是管理 sys.path 和组织好 __init__.py。不复杂但容易忽略细节。











