Python多入口模块导入问题咨询：无需改代码的最优方案

把项目包放到Lib\site-packages不是最佳实践 #

这么做会把你的项目代码和虚拟环境的第三方依赖混在一起，既不利于项目的版本管理、备份迁移，还可能和其他项目的同名包产生冲突，不推荐。

无需修改代码的解决方案（保留包在根目录） #

方案1：用绝对导入+动态添加根目录到sys.path #

在apps/main_app.py开头添加一段代码，自动把项目根目录（也就是main.py所在的目录）加入Python的模块搜索路径：

import sys
from pathlib import Path

# 获取项目根目录的绝对路径
root_dir = Path(__file__).parent.parent
if str(root_dir) not in sys.path:
    sys.path.append(str(root_dir))

之后main_app.py里统一用绝对导入：

from apps.st import speedtest
from apps.quota import quota

这样不管你是直接运行apps/main_app.py，还是从根目录的main.py导入运行，都能正常导入模块，不用改代码。

方案2：将项目设为可安装的开发包（更规范） #

在项目根目录创建pyproject.toml文件，内容如下：

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

[project]
name = "apps"
version = "0.1.0"

然后在虚拟环境里运行：

pip install -e .

这是开发模式安装，会把你的apps包链接到虚拟环境的site-packages里，但不会复制文件，修改项目代码后立即生效。之后不管从哪里运行，都可以直接用绝对导入：

from apps.st import speedtest
from apps.quota import quota

这种方式更符合Python项目的规范，适合长期维护的项目。

注意点 #

• 之前的导入写法有错误：from quota import quota.py是错的，应该写成from quota import quota（如果quota.py里的目标对象叫quota），或者直接import quota；相对导入的正确写法是from .st import speedtest（中间不要加空格）。

内容的提问来源于stack exchange，提问作者Adel.Ali