Python相对导入异常，sudo调用虚拟环境运行脚本时找不到自定义模块的问题咨询

• 直接运行python pipelines/main_pipeline1.py时，Python会将当前运行脚本所在目录（即prj/src/pipelines/）作为模块搜索的第一优先级路径，common模块位于上一级的prj/src/下，不在该路径范围内，因此触发ModuleNotFoundError。
• 部分Linux发行版的sudo默认安全策略会过滤PYTHONPATH等环境变量，即使加-E参数也无法保留手动配置的路径，因此依赖环境变量的方案无法稳定生效。

所有方案均不需要管理员手动修改环境变量，适配sudo运行场景，按推荐优先级排序：

方案1：代码内自动注入项目路径（零依赖、最快落地） #

在所有包含入口的脚本（main_pipeline1.py、main_pipeline2.py）的所有导入语句之前，添加以下路径自动识别逻辑：

import sys
from pathlib import Path
# 自动将src根目录（common模块所在目录）加入模块搜索路径
sys.path.append(str(Path(__file__).resolve().parent.parent))

# 原有导入逻辑正常写即可
import common.common1

如果需要兼容Python 3.3以下的旧版本，需在common/、pipelines/目录下各新建一个空的__init__.py文件，标记为合法的Python包。

运行命令直接使用绝对路径调用解释器即可：

# 普通用户运行
python /绝对路径/prj/src/pipelines/main_pipeline1.py
# sudo运行（直接调用虚拟环境解释器，不需要依赖环境变量）
sudo /绝对路径/prj/venv/bin/python /绝对路径/prj/src/pipelines/main_pipeline1.py

优势：无任何额外配置要求，代码迁移到其他机器也能正常运行，完全屏蔽环境差异。

方案2：打包为标准Python模块（适合长期维护项目） #

将项目改造为符合Python规范的可安装包，通过虚拟环境的包管理机制注册模块路径，无需手动配置路径。

1. 调整目录结构（仅新增空文件，不改动现有代码逻辑）：

prj
 |- pyproject.toml  # 新增
 |- src
 |  |- common/
 |     - __init__.py  # 新增空文件
 |     - common1.py
 |     - common2.py
 |  |- pipelines/
 |     - __init__.py  # 新增空文件
 |     - main_pipeline1.py
 |     - main_pipeline2.py
 |- data/ ...
 |- doc/ ...

2. 新增pyproject.toml配置（setuptools标准配置）：

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

[project]
name = "prj-pipeline"
version = "0.1.0"

[tool.setuptools.packages.find]
where = ["src"]

3. 在虚拟环境中执行一次安装（仅需配置时操作一次，后续无需重复）：

cd /绝对路径/prj
/绝对路径/prj/venv/bin/pip install -e .

安装完成后，common模块会被永久注册到虚拟环境的搜索路径中，普通用户或sudo调用虚拟环境解释器时均可正常导入。
优势：符合Python包管理标准，后续可直接注册命令行入口，进一步简化运行命令。

方案3：封装shell启动脚本（对非技术管理员最友好） #

在项目根目录新增shell包装脚本，完全屏蔽Python解释器路径、参数等细节，管理员仅需执行该脚本即可。

1. 新建prj/run_pipeline1.sh，内容如下：

#!/bin/bash
# 自动定位项目根目录、虚拟环境路径
PROJ_ROOT="$(cd "$(dirname "$0")" && pwd)"
exec "$PROJ_ROOT/venv/bin/python" "$PROJ_ROOT/src/pipelines/main_pipeline1.py"

2. 给脚本添加执行权限：

chmod +x /绝对路径/prj/run_pipeline1.sh

管理员运行时仅需执行以下命令，无需了解任何Python配置细节：

# 普通运行
/绝对路径/prj/run_pipeline1.sh
# sudo运行
sudo /绝对路径/prj/run_pipeline1.sh

优势：完全隔离Python相关逻辑，管理员仅需知晓脚本路径即可操作。

• 不要在导入语句中添加.py后缀，Python导入机制不支持该写法。
• 无需额外折腾sudo -E参数，上述方案均不依赖用户环境变量，不受系统sudo安全策略限制。
• 不要硬编码绝对路径，使用__file__自动定位的逻辑可跨机器、跨目录正常运行。

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