Python相对导入报错ImportError: no known parent package如何解决

你遇到的报错核心原因是：直接执行project/server/main.py时，Python会将main.py所在的server目录作为顶层执行上下文，相对导入语法..需要你的脚本作为包的一部分运行，而单独执行的脚本没有父包信息，因此触发ImportError。
VSCode能自动补全是因为IDE默认将你打开的工作区根目录加入了Python模块搜索路径，和实际运行时的搜索路径不一致，才会出现补全正常、运行失败的差异。

下面是3种最常用的适配方案，根据你的使用场景选择即可：

方案1：以模块形式运行脚本（推荐，无侵入式修改） #

不要直接运行main.py文件，而是切换到project目录的父目录，执行如下命令：

python -m project.server.main

如果需要在VSCode中直接点击运行生效，修改.vscode/launch.json的运行配置，添加/修改以下字段：

{
  "name": "Python: Module Run",
  "type": "python",
  "request": "launch",
  "module": "project.server.main",
  "cwd": "${workspaceFolder}/.." // 调整为你project目录的父目录路径
}

方案2：动态添加模块搜索路径（适合快速调试小项目） #

在main.py的最顶部添加路径注入代码，之后直接用绝对导入语法导入即可：

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

# 后续导入直接写绝对路径即可，不需要相对导入
from utils.module import my_function

方案3：安装本地项目包（适合长期维护的项目） #

在project的父目录下创建pyproject.toml配置文件，声明项目为可安装包，之后执行pip install -e .将当前项目以可编辑模式安装到Python环境中，之后无论在哪个路径下运行脚本，都可以直接通过from utils.module import my_function导入对应函数。

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