Spyder环境下跨目录模块类导入失败问题求助

首先咱们先梳理下你的项目结构（根据描述推测）：

My_code_folder/
├── __init__.py
├── lab_A/
│   ├── __init__.py
│   ├── models_A/
│   │   ├── __init__.py
│   │   ├── app_A1/
│   │   │   ├── __init__.py
│   │   │   └── x.py  # 包含你要导入的类
└── y.py  # 你要导入类的目标文件

先逐个分析你尝试的几种方式为什么会出错：

• 第一种方式：sys.path.append('../') 的问题在于，相对路径是基于Spyder的当前工作目录，而不是y.py所在的目录。如果Spyder的工作目录没设对，../指向的就不是My_code_folder，自然找不到lab_A这个包。
• 第二种方式：相对导入from .lab_A...只能在包内部模块被导入时使用。如果你直接运行y.py（比如Spyder里点运行），它会被当作顶层脚本（__main__模块），此时Python不知道它属于哪个父包，就会报ImportError: attempted relative import with no known parent package。
• 第三种方式：硬编码绝对路径from Users.User_ME.My_code_folder...既不灵活（换机器就失效），而且需要这个完整路径在sys.path里才行，否则Python找不到对应的包。
• 第四种方式：你把app_A1目录加到了sys.path，但之后写from app_A1 import x是错的——x.py是app_A1下的模块，应该直接import x或者from x import 你的类名，而不是从app_A1导入x。

正确的解决方法 #

我推荐两种靠谱的方式，任选其一即可：

方法1：动态添加项目根目录到sys.path（最通用）

用pathlib模块动态获取项目根目录，避免硬编码路径，在不同环境都能运行。假设y.py在My_code_folder根目录下，代码如下：

import sys
from pathlib import Path

# 获取当前脚本所在的目录（也就是My_code_folder）
project_root = Path(__file__).parent
# 将项目根目录添加到Python的模块搜索路径
sys.path.append(str(project_root))

# 现在可以正常导入x.py里的内容了
from lab_A.models_A.app_A1.x import 你的类名
# 或者导入整个x模块
from lab_A.models_A.app_A1 import x

如果y.py在My_code_folder的子目录里（比如lab_B），只需要调整project_root的层级：

# 往上两级目录到My_code_folder
project_root = Path(__file__).parent.parent

方法2：直接设置Spyder的工作目录

打开Spyder后，点击顶部菜单栏的文件 > 设置工作目录，选择你的My_code_folder目录。这样Python会自动把工作目录加入sys.path，你直接写绝对导入就行，不需要手动改sys.path：

from lab_A.models_A.app_A1 import x

关键提醒 #

• 不要在直接运行的脚本里用相对导入（from .xxx import ...），这种写法只适合在包内部被其他模块导入时使用。
• 尽量用动态路径替代硬编码的绝对路径，这样你的代码在任何机器上都能正常运行。

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