如何用GitPython(v2.1.*)执行git config --global --add safe.directory命令？

错误原因 #

你遇到的could not lock config file /nonexistant/.gitconfig错误，是因为执行--global参数时，脚本的环境变量HOME指向了不存在的路径，或是普通用户没有权限访问/修改全局.gitconfig（比如之前用root运行导致配置文件属主为root）。而repo.config_writer()能正常运行，是因为它操作的是仓库本地配置文件（some_dir/.git/config），普通用户对该目录有读写权限。

解决方案 #

方法一：添加仓库本地safe.directory（推荐） #

不需要修改全局配置，直接给当前仓库添加本地的safe.directory配置，利用你已经验证可行的config_writer()方法：

import git

some_dir = "/path/to/your/repo"
repo = git.Repo(some_dir)

# 获取仓库本地配置的写入器
local_config = repo.config_writer()
# 添加safe.directory配置
local_config.set_value("safe", "directory", some_dir)
# 保存配置并释放锁
local_config.release()

这等价于执行Git命令：

git config --add safe.directory "some_dir"

普通用户对自己的仓库目录拥有完全权限，不会出现锁文件或权限错误。

方法二：正确执行全局配置（如需全局生效） #

如果必须修改全局配置，需要确保脚本运行环境的HOME变量指向普通用户的主目录，并且全局.gitconfig文件权限正确：

1. 修复全局配置文件权限（如果之前用root操作过）：

sudo chown $USER:$USER ~/.gitconfig

2. 在Python脚本中确保环境变量正确，并执行全局配置：

import os
import git

some_dir = "/path/to/your/repo"
# 确保HOME指向普通用户主目录
os.environ['HOME'] = os.path.expanduser('~')

git_cmd = git.cmd.Git(some_dir)
# 执行全局添加命令
git_cmd.config("--global", "--add", "safe.directory", some_dir)

也可以显式指定全局配置文件路径，避免环境变量问题：

git_cmd.config("--file", os.path.expanduser("~/.gitconfig"), "--add", "safe.directory", some_dir)

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