如何动态获取Python模块绝对路径并正确完成导入？

首先纠正2个核心认知错误 #

• sys.path 接收的参数是Python搜索模块的目录路径，不是模块.py文件本身的路径，之前写的sys.path.insert(0, '../../src/lib/myModule.py')属于用法错误，就算路径写对也无法正常导入
• 直接用Path('myModule.py').abspath()获取路径的逻辑不可靠：这种写法是基于执行Python命令时的工作目录拼接绝对路径，和脚本本身的存放位置无关，只要执行目录变了，返回结果就会出错。

零依赖通用实现（适配任意执行位置，包括Jenkins任务） #

这个方案不依赖执行目录、不硬编码绝对路径，只要项目目录结构不改动，在本地、测试机、CI环境都能正常运行：

1. 在项目根目录projectRoot下新建一个空的标记文件，命名为.project_root，这个文件固定存放在根目录不移动，作为定位项目根的锚点
2. 在所有需要导入myModule的脚本开头，加入如下路径查找逻辑：

import sys
from pathlib import Path

# 从当前脚本自身的存放路径开始，向上遍历查找项目根锚点
current_file = Path(__file__).resolve()
project_root = None
for parent_dir in current_file.parents:
    if (parent_dir / ".project_root").exists():
        project_root = parent_dir
        break

if not project_root:
    raise RuntimeError("定位项目根失败，请确认.project_root标记文件存在于项目根目录")

# 将自定义模块所在的目录加入Python搜索路径
module_search_path = project_root / "src" / "lib"
sys.path.insert(0, str(module_search_path))

# 路径添加完成，直接导入即可
import myModule

其他方案的缺陷说明 #

• 硬编码绝对路径：换运行环境就失效，本地开发机、Jenkins节点、测试服务器的项目存放路径不可能完全一致，后续维护成本极高
• 写死相对路径：每换一个目录下的调用脚本，就要重新计算../的层级，新增调用方时极易写错，完全不可维护
• 依赖工作目录的路径获取：只要执行Python命令的位置不是脚本预期的目录，路径就会计算错误，无法适配CI任务这类执行位置不固定的场景

长期规范优化方案 #

如果后续调用场景进一步增多，可以把项目改造成可编辑安装的Python包：在项目根目录新增pyproject.toml配置文件，在对应Python环境中执行pip install -e .将项目以可编辑模式安装到环境中，之后所有脚本不需要手动修改sys.path，直接写import myModule即可完成导入，是最规范的实现方式。

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