Python相对导入与绝对导入失效问题求助

问题根源 #

1. 相对导入失败：直接运行spider.py时，Python将其视为独立顶层脚本，而非scraper.converter.spiders包的一部分，因此无法识别..这类相对导入的父包结构。
2. 绝对导入失败：scraper所在的目录不在Python的模块搜索路径（sys.path）中，Python找不到这个顶级包。

解决方案 #

方案1：以包模块方式运行（推荐） #

不要直接执行spider.py，而是从scraper的上级目录，用-m参数以包模块的方式运行：

python -m scraper.converter.spiders.spider

这种方式会让Python把scraper当作完整包处理，此时你原来的两种导入方式都能正常工作：

• 相对导入：from .. import items
• 绝对导入：from scraper.converter import items

方案2：临时修改sys.path（不推荐，仅应急） #

如果必须直接运行spider.py，可以在文件开头添加代码，将scraper的父目录加入Python的搜索路径：

import sys
from pathlib import Path

# 获取scraper目录的父路径，添加到sys.path
sys.path.append(str(Path(__file__).resolve().parent.parent.parent))

# 现在可以正常使用绝对导入
from scraper.converter import items

或者调整路径后用相对包导入：

import sys
from pathlib import Path

sys.path.append(str(Path(__file__).resolve().parent.parent))

from converter import items

⚠️ 注意：这种方式会破坏包的封装性，移植性差，仅适合临时测试。

方案3：添加入口脚本（规范方式） #

在scraper目录下创建一个入口脚本main.py：

# scraper/main.py
from converter.spiders.spider import 你的函数或类

if __name__ == "__main__":
    # 调用spider里的逻辑
    你的函数或类()

然后从scraper的上级目录运行：

python scraper/main.py

此时spider.py中的相对导入from .. import items就能正常生效。

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