模块级导入未在文件顶部问题：无需重构项目的标准解决办法？

下面提供几种无需重构现有项目结构的标准解决方法：

方法一：调整代码顺序，将所有模块级操作移至顶部 #

把sys、Path的导入以及路径添加操作全部放在文件最开头，确保所有模块级导入都处于文件顶部：

import sys
from pathlib import Path

# 模块初始化阶段添加路径，属于顶部合法操作
sys.path.append(str(Path(__file__).resolve().parents[2]))

from utils.utils import *

pycodestyle 只会检查模块级导入是否在顶部，路径修改属于模块初始化代码，放在导入语句之后、业务代码之前是合规的。

方法二：通过环境变量PYTHONPATH指定根目录 #

在运行脚本前，将项目根目录（Main Folder）添加到PYTHONPATH环境变量中，这样Python会自动检索该路径下的模块，无需在代码中修改sys.path：

• Windows 命令行：

set PYTHONPATH=C:\实际路径\Main Folder

• Linux/macOS 终端：

export PYTHONPATH=/实际路径/Main Folder

之后在Myfile.py中直接写合规的导入语句即可：

from utils.utils import *

这种方式完全符合PEP8规范，是最推荐的标准做法。

方法三：使用相对导入（需按包方式运行） #

利用Python的相对导入语法，从当前文件向上回溯到Utils模块所在路径：

from ...Utils.utils import *

注意：使用相对导入时，必须将Main Folder作为工作目录，或者通过模块方式运行脚本（而非直接执行文件）：

cd /路径/to/Main Folder
python -m Project2.MyModule.MyWorkingDirectory.Myfile

这种方式无需修改sys.path，也符合pycodestyle要求，但对运行方式有一定限制。

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