Python子目录相对导入父目录类报ImportError问题咨询

你遇到的ImportError: attempted relative import with no known parent package本质是Python运行机制导致的：

• 带..的相对导入语法，只有当当前文件作为包内模块被导入时才能生效，如果你直接运行tests/mytest.py脚本，Python会把这个文件当成顶层独立脚本，根本识别不到它的父级包结构，自然找不到上层目录的proxy.py。
• VSCode能识别这条导入是因为它做了静态目录结构扫描，和Python运行时的包识别逻辑不是一回事，所以会出现编辑器不标红但运行报错的情况。
• 你把mytest.py移到和proxy.py同级就能跑，是因为Python运行单脚本时，默认会把脚本所在目录加入模块搜索路径，同目录导入不需要识别包层级，属于特殊场景下的兼容，跨目录时这个机制不生效。

方案1：标准包结构方案（推荐正式项目使用） #

1. 先给包目录补全标识文件：在code目录、tests目录下各新建一个空的__init__.py文件，标记这两个目录是Python可识别的包，调整后的目录结构如下：

- root
  - code
    __init__.py
    main.py
    proxy.py
    - tests
      __init__.py
      mytest.py

2. 不要直接在tests目录下点击运行mytest.py，打开终端切换到root目录（即code文件夹的上一级），用模块模式执行脚本：

python -m code.tests.mytest

这种执行方式下Python会完整解析整个包的层级关系，你原来写的from ..proxy import Proxy可以正常运行，完全符合Python的模块导入规范。

方案2：快速调试方案（适合临时跑单测试文件） #

如果不想调整执行命令，想直接在VSCode里点运行就能跑通，可以手动把父目录加入Python的模块搜索路径：

1. 打开mytest.py，在所有导入语句的最开头添加如下代码：

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

2. 把原来的相对导入改成直接导入：

from proxy import Proxy

改完之后不管你在哪个目录执行mytest.py，都能正常找到Proxy类，不需要调整运行参数，缺点是路径写入了代码里，更适合临时调试场景。

注意：不要为了省事直接写from code.proxy import Proxy这类硬编码顶层包名的导入，这种写法依赖执行时的工作目录，换个位置启动脚本就会报错，可移植性很差。

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