Python报相对导入无已知父包ImportError错误排查求助

• 已查阅该问题的5种不同解答，所有方案均未在本地环境生效，仅跳转已有“已解答”帖子的方式无法解决问题，请勿直接关闭该问题。
• 运行环境：Python 3.7.9、Windows 10、VS Code
• 核心需求：运行misc目录下的test.py脚本，从同级父目录下的utils/add_technical_indicators.py文件中导入add_technical_indicators函数。

• 方案1：将待导入的.py文件移动到当前运行脚本的同级目录。该方法虽能临时解决问题，但不符合项目目录规范，不属于最优方案，正常项目结构应支持从父目录导入模块而不触发报错。
• 方案2：在待导入文件所在目录创建__init__.py文件，通过import 包名方式导入包。已在utils文件夹下创建内容为import add_technical_indicators的__init__.py文件，同时在misc文件夹下创建内容为import test的__init__.py文件，问题仍未解决。

目录逻辑：test.py位于misc子目录，待导入的add_technical_indicators.py位于和misc同级的utils子目录，初始设计的导入逻辑为从test.py所在位置向上返回一级目录后，进入utils文件夹找到对应文件，导入目标函数。

• from ..utils.add_technical_indicators import add_technical_indicators
• from .utils.add_technical_indicators import add_technical_indicators
• from utils.add_technical_indicators import add_technical_indicators
  注：该方式本身逻辑不成立，因为add_technical_indicators.py不在运行脚本的同级目录下，直接运行时Python搜索路径无法命中该文件

相对导入的生效前提是脚本必须作为包内模块被Python解释器加载，不能直接作为顶层入口脚本运行。
直接点击运行按钮执行test.py时，Python会将test.py所在的misc目录加入模块搜索路径，此时test.py的__name__属性为__main__，不存在父包标识，所有带.前缀的相对导入都会触发“无已知父包”报错。此前创建__init__.py的操作本身符合包结构要求，但运行方式错误，无论怎么调整导入语句的点号数量都无法解决问题。
另外在__init__.py中写入import xxx的操作是多余的：标识目录为Python包只需要存在空的__init__.py文件即可，额外写入导入语句反而可能触发循环导入、路径识别错误等问题。

二选一即可，无需改动现有目录结构。

方案1：调整运行方式（最符合Python包规范） #

1. 清空misc、utils两个目录下__init__.py的所有内容，保留空文件即可。
2. 在misc、utils共同所在的项目根目录下，新建一个空的__init__.py文件。
3. 不要直接点击VS Code的运行按钮执行test.py，打开终端切换到项目根目录的上一级目录，执行以下命令：
   python -m 你的项目根目录名.misc.test
   例如项目根目录名为stock_analysis，则执行命令为python -m stock_analysis.misc.test
   该运行方式下Python会将整个项目作为正式包加载，原有from ..utils.add_technical_indicators import add_technical_indicators导入语句可正常生效。

方案2：临时追加模块搜索路径（改动量最小） #

打开test.py，在所有业务导入语句的最开头加入以下代码：

import sys
from pathlib import Path
# 将项目根目录加入Python模块搜索路径
sys.path.append(str(Path(__file__).parent.parent.resolve()))

添加完成后，将原有相对导入语句替换为绝对导入：
from utils.add_technical_indicators import add_technical_indicators
修改完成后直接点击VS Code的运行按钮即可正常执行，无需调整运行命令。

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