Python怎么引入同目录下的py文件

一、同目录文件的导入方式与基础示例

假设我们在同一个项目文件夹 my_project 下存放了两个 Python 文件：一个是提供运算工具的 utils.py，另一个是负责主流程调用的 main.py。

my_project/
├── utils.py     # 工具函数模块
└── main.py      # 主程序入口

在 utils.py 中定义我们需要复用的函数和全局变量：

# utils.py
def get_greeting(name):
    return f"你好，{name}！"

PI = 3.14159

在同目录下的 main.py 中，可以通过两种标准方式进行引入和调用：

1. 直接导入整个模块（推荐）

# main.py
import utils

message = utils.get_greeting("张三")
print(message)
print(f"圆周率近似值：{utils.PI}")

2. 从模块中精确导入指定对象

# main.py
from utils import get_greeting, PI

message = get_greeting("李四")
print(message)
print(f"圆周率近似值：{PI}")

二、同目录引入的操作步骤

为了保证引入顺利进行，建议按照以下规范步骤组织和执行代码：

1. 创建工作目录并放入源码文件：在终端中进入项目专用文件夹，确保两个 .py 文件位于完全平级的同一路径下。
2. 编写目标模块的功能定义：在被引用文件中实现具体的函数、类或配置对象，避免在模块顶层直接书写耗时的业务主执行语句。
3. 在主程序顶部声明引入语句：使用 import 语法，并注意文件名与模块名的一致性（不需要写 .py 后缀）。
4. 在同级目录下执行脚本：在命令行终端定位到该目录后，运行 python main.py 检查输出结果。

三、底层机制：为什么同目录文件可以直接 import？

很多初学者会疑惑：为什么不需要填写完整的文件路径，Python 就能自动找到同级文件？这背后的核心支撑是 Python 解释器的模块检索机制 sys.path。

当我们在命令行中执行 python main.py 时，Python 解释器在初始化环境时会自动构建一个名为 sys.path 的字符串列表。该列表决定了模块的检索次序：

• sys.path[0]（首位优先级）：包含输入脚本的目录路径。如果通过命令行执行脚本，该位置就是被执行脚本所在文件夹的绝对路径；如果是交互式终端，则为空字符串表示当前工作目录。
• Python 标准库路径：包含 Python 内置模块（例如 os、sys、math 等）。
• 第三方安装包路径（site-packages）：存放通过 pip install 安装的各类依赖库。

因为当前脚本所在的目录始终排在检索路径的最前端，所以 Python 会优先检查同级目录下是否存在同名 .py 文件。一旦匹配成功，解释器就会读取源码、编译字节码并存入内存字典 sys.modules，完成加载。

四、常见问题排查与注意事项

虽然同目录导入语法非常简明，但在实际工程与 IDE 使用中，经常会遇到以下四种典型异常状况：

1. 报错 ModuleNotFoundError: No module named 'xxx'

原因：执行脚本时的当前工作目录与预期不符。例如在项目的上级目录执行了 python my_project/main.py，或者在集成开发环境（如 VS Code、PyCharm）中将工作区根目录设为了其他路径。虽然直接运行 main.py 时 sys.path[0] 通常会被正确设置为文件所在目录，但如果通过某些启动插件或模块方式启动，可能会遗失该路径。

2. 文件名与系统标准库冲突导致的遮蔽效应

原因：如果给同目录下的文件起名为 math.py、random.py、json.py 或 test.py，由于同级目录优先级最高，当其他第三方模块或内置代码尝试 import math 时，会错误加载你写的脚本，引发令人费解的属性缺失或导入报错。

3. 循环引用引发的 ImportError

原因：如果在 a.py 中写了 import b，同时在 b.py 中也写了 import a，在模块初次加载未完成时就尝试读取对方的全局属性，会抛出 AttributeError: partially initialized module 'xxx' has no attribute 'yyy'。

4. 误用相对导入符号 from . import xxx

原因：有些开发者在平级单脚本中写成 from . import utils。当直接使用 python main.py 运行该文件时，Python 会将该脚本的模块名标记为 __main__，不存在上层包信息，从而抛出错误：ImportError: attempted relative import with no known parent package。

五、模块导入的核心建议与总结

为了让项目代码结构更清晰、更易维护，建议在实际开发中遵守以下约定：

总的来说，引入同目录下的 Python 文件不需要复杂的系统配置，只需确保两个文件处于平级目录，并在主程序中使用标准 import 语句即可快速完成模块拆分与复用。