Python模块导入冲突求助：pid.py与system.py运行矛盾解决方案

问题本质 #

当模块同时需要单独运行和被上层包导入时，Python的模块搜索路径会随运行入口变化，导致绝对/相对导入无法同时适配两种场景。

方案1：使用相对导入（推荐用于包内模块调用） #

将pid.py中的导入改为同目录相对导入，适配包内调用逻辑：

# pid.py 中修改导入语句
from . import tunning_methods

单独测试pid.py时，需以包模块方式运行（在main目录下执行）：

python -m pid.pid

这种方式会让Python将pid识别为合法包，相对导入在两种场景下都能正常工作。

方案2：动态添加模块搜索路径 #

在pid.py开头添加代码，强制将当前脚本所在目录加入Python搜索路径，兼容两种运行场景：

# pid.py 开头添加
import sys
import os
current_script_dir = os.path.dirname(os.path.abspath(__file__))
if current_script_dir not in sys.path:
    sys.path.append(current_script_dir)

# 原导入语句保留
import tunning_methods

无论直接运行pid.py，还是从system.py导入，Python都能找到tunning_methods模块。

方案3：统一项目运行入口（大型项目首选） #

大型项目建议统一以**项目根目录（main目录）**作为所有脚本的运行入口，避免路径混乱：

1. 在main目录下创建测试脚本test_pid.py：

from pid import pid
pid.testfunc()

2. 执行测试时运行：

python test_pid.py

3. 可将pid.py中的if __name__ == "__main__"测试代码移到该脚本中，保持模块文件的纯粹性。

内容的提问来源于stack exchange，提问作者emanuel.thiago001