Python模块导入问题：IPython可运行，终端直接执行报错

项目目录结构 #

proyect/
|-- src/
|   |-- __init__.py
|   |-- frontend/
|   |   |-- __init__.py
|   |   |-- file_select.py
|   |-- config/
|       |-- __init__.py
|       |-- variables.py

问题场景 #

在file_select.py中使用绝对导入语句：

from src.config import variables as var

• 在IPython中运行该文件时一切正常
• 直接在终端运行file_select.py时，抛出错误：

Traceback (most recent call last):
  File "c:\Users\spinc\Desktop\proyect\src\frontend\file_select.py", line 3, in <module>
    from src.config import variables as var
ModuleNotFoundError: No module named 'src'

尝试使用相对导入from ..config import variables，无论终端还是IPython都无法正常运行。

可行解决方案 #

方案1：动态添加项目根目录到Python路径 #

在file_select.py的开头添加以下代码，将项目根目录（proyect文件夹）加入sys.path，确保两种环境都能找到src模块：

import sys
from pathlib import Path

# 定位项目根目录：当前文件 -> frontend -> src -> proyect
project_root = Path(__file__).parent.parent.parent
sys.path.append(str(project_root))

# 原导入语句保持不变
import tkinter as tk
from tkinterdnd2 import *
from src.config import variables as var

方案2：以模块方式运行脚本（相对导入适配） #

修改file_select.py中的导入语句为相对导入：

from ..config import variables as var

然后从项目根目录（proyect文件夹下）执行终端命令：

python -m src.frontend.file_select

这种方式会将src识别为一个包，相对导入即可生效；IPython中若以模块方式运行（如run -m src.frontend.file_select）也能正常工作。

方案3：设置PYTHONPATH环境变量 #

将项目根目录添加到系统的PYTHONPATH环境变量中：

• Windows终端：

  set PYTHONPATH=C:\Users\spinc\Desktop\proyect
  

• Linux/macOS终端：

  export PYTHONPATH=/home/xxx/proyect
  

设置完成后，直接在终端运行file_select.py即可使用原绝对导入语句。此方法为全局设置，可能影响其他Python项目，需谨慎使用。

问题原因 #

• 终端直接运行脚本时，Python仅将脚本所在目录（src/frontend）加入sys.path，无法识别上层的src模块；而IPython默认会将当前工作目录或脚本的上层目录加入路径，因此能找到src。
• 相对导入仅适用于包结构中的模块，直接运行脚本时，该文件会被当作顶层模块，相对导入语法失效。

附录：文件内容 #

file_select.py #

import tkinter as tk
from tkinterdnd2 import *
from src.config import variables as var

background = var.background
[...]

variables.py #

background = "#000739"
title = "Title"

内容的提问来源于stack exchange，提问作者Sebastián P. Pincheira