Python如何从高祖父级目录导入模块？导入utils.py报错求助

• 第一个方案路径匹配逻辑错误：你插入到sys.path的是C:\\marketing-reports\\Reporting路径，而utils.py存放在上一级的marketing-reports根目录下，添加的路径不包含目标模块所在的父目录。同时导入语句from Reporting import utils逻辑有误：把Reporting路径加入sys.path后，Python只会在该路径下检索名为Reporting的模块，自然触发模块不存在报错。
• 第二个方案存在两处问题：
  1. 依赖模块误用：你使用的path是过时的第三方库，Python标准库内置的路径处理模块为pathlib.Path，无需额外安装即可使用
  2. 父目录跳转层数不足：current.py的路径为marketing-reports/Reporting/Adhoc/for_sales/salesperson1/current.py，距离根目录有5层路径，仅调用两次parent只能跳转到for_sales目录，无法定位到根目录下的utils.py

临时适配方案（无需修改项目配置） #

直接用标准库pathlib计算根目录路径，加入sys.path后导入即可：

import sys
from pathlib import Path

# 从current.py所在路径往上跳5层，到达marketing-reports根目录
root_dir = Path(__file__).absolute().parents[4]
sys.path.append(str(root_dir))

# 直接导入根目录下的utils.py
import utils

项目级规范方案（适配IDE、全局生效） #

如果需要长期维护项目，推荐用可编辑安装的方式配置，避免每次写脚本都修改sys.path：

1. 在项目根目录marketing-reports下新建空文件__init__.py，将整个项目标记为Python可识别的包结构
2. 在根目录下新建pyproject.toml配置文件，写入以下内容：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "marketing-reports"
version = "0.1.0"
packages = ["."]

3. 打开终端进入项目根目录，执行命令pip install -e .，将当前项目以可编辑模式安装到Python环境中。之后任意层级的脚本都可以直接用import utils导入根目录模块，VSCode的Pylance也不会报导入错误。
   如果不需要全局生效仅需要Pylance识别，可以在项目的.vscode/settings.json中添加配置：

{
  "python.analysis.extraPaths": ["${workspaceFolder}"]
}

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