Python 3.8+非平行项目结构的跨目录正确导入方案咨询

针对你的目录结构和需求，这里提供两种可靠的实现方式，均兼容Python 3.8+：

方案一：稳定路径注入（直接执行脚本场景推荐） #

修改./Tools/ToolCategory2/simplify.py的导入代码，通过绝对路径定位Utils仓库根目录，确保从任意路径执行脚本都能正确导入：

import sys
from pathlib import Path

# 获取Utils目录的绝对路径，不受执行路径影响
utils_root = Path(__file__).resolve().parents[2]
# 将Utils根目录加入Python的模块搜索路径
sys.path.insert(0, str(utils_root))

# 现在可以正常导入Library中的类（建议明确导入，避免*带来的命名冲突）
from Library.SomeClasses import YourTargetClass

为什么之前的路径法失效？ #

你之前的代码用了Path(__file__).parent.parent.parent，但没有调用resolve()转换为绝对路径。当从非Utils目录执行脚本时，__file__可能是相对路径，导致父目录计算出错。resolve()会确保路径是绝对路径，parents[2]则精准定位到Utils根目录（从simplify.py往上数两级父目录：ToolCategory2 → Tools → Utils）。

方案二：将Utils作为可安装包（长期维护推荐） #

如果这个Utils仓库是长期复用的项目，更规范的做法是将其打包为可安装的Python包，彻底解决路径问题：

1. 在Utils根目录下创建pyproject.toml文件：

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

[project]
name = "utils"
version = "0.1.0"
packages = ["Library", "Tools"]

2. 打开终端，进入Utils根目录，执行开发模式安装：

pip install -e .

3. 之后无论从哪个路径执行simplify.py，都可以直接导入：

from Library.SomeClasses import YourTargetClass

为什么相对导入法失效？ #

Python的相对导入仅适用于模块被作为包的一部分导入的场景（比如通过from Utils.Tools.ToolCategory2 import simplify导入脚本）。当你直接执行simplify.py时，该脚本会被当作顶层__main__模块，不支持相对导入语法，因此控制台执行会失败；而PyCharm是将Utils作为项目根目录，默认把脚本当作包的一部分处理，所以能运行。

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