如何在本地克隆的Git仓库中用Python读取其他目录的文件？

核心思路：基于仓库根目录构建绝对路径 #

不要依赖相对路径（比如../other_dir/file.txt），这类路径的有效性完全取决于脚本的执行位置，一旦在仓库外运行就会失效。正确的做法是先定位Git仓库的根目录，再基于这个固定根路径拼接目标文件的位置。

具体实现方法 #

方法1：通过Git命令获取仓库根目录 #

直接调用Git内置命令获取仓库根路径，这是最可靠的方案，只要当前工作目录在Git仓库范围内就能生效：

import subprocess
import os

def get_repo_root():
    try:
        repo_root = subprocess.check_output(
            ["git", "rev-parse", "--show-toplevel"],
            stderr=subprocess.STDOUT,
            text=True
        ).strip()
        return repo_root
    except subprocess.CalledProcessError:
        raise RuntimeError("当前目录不在Git仓库中")

# 示例：读取仓库内data目录下的config.json
repo_root = get_repo_root()
target_file = os.path.join(repo_root, "data", "config.json")

with open(target_file, "r") as f:
    content = f.read()

方法2：基于模块文件路径推导（无Git依赖） #

如果不想依赖Git命令，可以通过当前模块的文件路径向上遍历，找到包含.git文件夹的目录：

import os

def get_repo_root():
    current_dir = os.path.dirname(os.path.abspath(__file__))
    while current_dir != os.path.dirname(current_dir):  # 遍历到系统根目录为止
        if os.path.exists(os.path.join(current_dir, ".git")):
            return current_dir
        current_dir = os.path.dirname(current_dir)
    raise RuntimeError("未找到Git仓库根目录")

# 示例：读取仓库内utils目录下的helper.py
repo_root = get_repo_root()
target_file = os.path.join(repo_root, "utils", "helper.py")

注意事项 #

• 禁止硬编码绝对路径：比如C:/Users/xxx/my_repo，换机器或路径变更后直接失效。
• 必须处理异常：要考虑不在Git仓库内、目标文件不存在等场景，添加对应的错误捕获逻辑。
• 保证跨平台兼容：使用os.path.join而非手动拼接路径分隔符（/或\），确保Windows和Linux环境都能正常运行。

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