FastAPI项目中能否获取项目根目录？该如何实现？

你遇到的问题是因为：

• __file__指向的是当前执行的脚本文件路径，所以在src/tool/graphics目录下的脚本中调用，只能拿到该子目录路径；
• sys.modules['__main__'].__file__返回uvicorn路径，是因为你用uvicorn启动项目时，__main__模块对应的是uvicorn的入口文件，而非你的项目脚本。

当然可以获取到项目根目录，以下是几种可靠的实现方式：

方法一：基于项目固定层级拼接 #

如果明确当前脚本在项目中的相对位置，直接向上拼接路径：

import os
# 假设当前脚本位于src/tool/graphics，往上三级就是项目根目录
root_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "../../.."))

优点：简单直接；缺点：项目结构变动时需要调整层级数。

方法二：基于项目标志性文件定位 #

通过检查项目根目录下的固定文件（如pyproject.toml、requirements.txt或README.md）来递归查找根目录：

import os

def get_project_root():
    current_dir = os.path.abspath(os.path.dirname(__file__))
    while True:
        # 检查当前目录是否存在项目标志性文件
        if os.path.exists(os.path.join(current_dir, "pyproject.toml")):
            return current_dir
        # 到达系统根目录仍未找到则抛出异常
        parent_dir = os.path.dirname(current_dir)
        if parent_dir == current_dir:
            raise FileNotFoundError("未找到项目根目录的标志性文件")
        current_dir = parent_dir

root_path = get_project_root()

优点：健壮性强，不受脚本位置变动影响；缺点：需要确保项目根下有固定的标志性文件。

方法三：通过环境变量指定 #

启动项目前手动设置环境变量，代码中直接读取：
启动命令（终端）：

export PROJECT_ROOT="/Users/john/source/reddwarf/backend/chat-server/"
uvicorn main:app --host 0.0.0.0 --port 8000

代码中读取：

import os
root_path = os.environ.get("PROJECT_ROOT")
if not root_path:
    raise ValueError("请先设置PROJECT_ROOT环境变量")

优点：灵活性高，适配不同部署环境；缺点：需要启动前手动配置环境变量。

方法四：在项目入口文件中定义根目录 #

如果项目入口是根目录下的main.py，直接在入口文件中定义根目录，其他模块导入使用：
main.py（项目根目录下）：

import os
PROJECT_ROOT = os.path.abspath(os.path.dirname(__file__))

其他模块中使用：

from main import PROJECT_ROOT

优点：统一管理，避免重复计算；缺点：依赖项目入口文件的位置固定。

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