为何不同电脑上Python的相对导入行为存在差异？

问题根源 #

两台电脑的Python模块查找路径（sys.path）配置存在差异：

• 主电脑的sys.path包含了Pypertext的父目录，widget被识别为顶层模块，直接from widget import baseWidget可正常导入。
• 另一台电脑的sys.path仅包含当前运行目录，必须通过相对导入from .widget import baseWidget才能定位同包内的模块。

解决方案 #

方案1：将Pypertext安装为可编辑包（推荐） #

把Pypertext转为正式Python包，实现跨环境统一识别：

1. 在Pypertext的父目录下创建setup.py文件，内容如下：

from setuptools import setup, find_packages

setup(
    name="pypertext",
    version="0.1",
    packages=find_packages(),
)

2. 在两台电脑上，进入Pypertext的父目录，执行命令：

pip install -e .

3. 所有模块内部统一使用绝对导入替换原有语句：

# 在htmlHeader.py等文件中修改导入
from pypertext.widget import baseWidget

该方式彻底解决兼容问题，同时方便后续模块的分发与维护。

方案2：统一配置sys.path（临时方案） #

若不想安装包，可在程序入口文件（如html.py）最顶部添加代码，强制将Pypertext目录加入模块查找路径：

import sys
from pathlib import Path

# 获取Pypertext目录的绝对路径
pypertext_root = Path(__file__).parent
if str(pypertext_root) not in sys.path:
    sys.path.insert(0, str(pypertext_root))

修改后，所有模块内部均可使用from widget import baseWidget，两台电脑导入逻辑保持一致。

方案3：统一使用相对导入并规范运行方式 #

所有模块内部导入改用相对导入（如from .widget import baseWidget），但运行时必须以包的方式启动，不能直接运行单个模块文件：

• 在Pypertext的父目录下执行：

python -m pypertext.html

这种方式会让Python将Pypertext识别为合法包，相对导入可在两台电脑正常生效。

内容的提问来源于stack exchange，提问作者user19926715