Python模块导入报错：无需sys.path.append如何调用core包？

问题根源 #

先理清楚两种执行方式的核心差异：

• 用python -m executor时，Python会自动把项目根目录（也就是/project）添加到sys.path模块搜索路径中，所以from core import ...能正常找到上层的core包。
• 直接运行python executor时，Python会把executor目录（/project/executor）作为当前工作目录加入sys.path，上层的core包不在这个路径范围内，因此抛出ModuleNotFoundError。

无需sys.path.append的解决方案 #

1. 把项目转为可安装的Python包（推荐长期维护的项目）

这是最规范的工程化做法，适合需要长期迭代的代码库。你只需要在项目根目录创建pyproject.toml配置文件，定义包结构：

在/project/pyproject.toml中添加：

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

[project]
name = "your-project-name"
version = "0.1.0"
packages = ["core", "executor"]

然后在项目根目录运行本地开发安装命令：

pip install -e .

安装完成后，core和executor会被注册为全局可导入的包，不管你在哪个目录执行python -m executor或相关模块，都能正常找到core。

2. 在项目根目录创建统一入口脚本

如果不想做包安装，可以在/project下新建一个run_executor.py入口文件，内容如下：

# 假设你的executor/__main__.py里有核心执行逻辑，比如main函数
from executor.__main__ import main

if __name__ == "__main__":
    main()
# 或者直接触发executor的执行逻辑：
# import executor.__main__

之后你只需要在项目根目录运行：

python run_executor.py

此时Python会自动把项目根目录加入sys.path，自然能找到core包。

3. 临时设置PYTHONPATH环境变量

如果只是临时测试，不想修改代码或配置文件，可以通过环境变量让Python识别core包：

• Linux/macOS：

  export PYTHONPATH=/path/to/project && python executor
  

• Windows（命令提示符）：

  set PYTHONPATH=C:\path\to\project && python executor
  

• Windows（PowerShell）：

  $env:PYTHONPATH = "C:\path\to\project"; python executor
  

这个方法会临时把项目根目录加入Python的模块搜索路径，无需改动任何代码。

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