Python项目如何实现从根目录以app前缀导入自有包？

当前你的项目能使用from api.endpoints.auth import authorization as auth_blueprint导入，却无法使用from app.api.endpoints.auth import authorization as auth_blueprint，核心原因是Python的模块搜索路径未包含项目根目录，导致app无法被识别为顶级包。以下是几种可行的解决方法：

方法1：临时添加项目根目录到PYTHONPATH #

在启动项目前，根据操作系统执行对应命令：

• Linux/macOS终端：

  export PYTHONPATH="/你的项目根目录绝对路径:$PYTHONPATH"
  

• Windows命令行：

  set PYTHONPATH=C:\你的项目根目录绝对路径;%PYTHONPATH%
  

之后再运行项目，即可使用带app前缀的导入语句。

方法2：代码中动态添加路径（适合调试） #

在项目启动文件（如app/main.py）的最顶部添加以下代码，将项目根目录加入Python搜索路径：

import sys
import os
# 获取项目根目录（app文件夹的父目录）
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if project_root not in sys.path:
    sys.path.append(project_root)

方法3：利用Poetry配置启动脚本 #

在pyproject.toml中添加脚本配置（假设启动逻辑在app/main.py的main函数中）：

[tool.poetry.scripts]
start = "app.main:main"

之后使用poetry run start启动项目，Poetry会自动处理路径问题，支持app前缀的导入。

方法4：将项目安装为可编辑包（推荐生产环境） #

在pyproject.toml中确保已配置packages：

[tool.poetry]
# 其他已有配置...
packages = [{ include = "app" }]

执行以下命令将项目以可编辑模式安装到虚拟环境：

poetry install

安装完成后，app会被识别为全局可导入的包，无论从哪里运行代码都能使用from app.api.endpoints.auth...的导入方式。

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