Windows系统用户用LibGit2Sharp v0.27+报错：仓库路径非当前用户所有

核心原因 #

LibGit2Sharp v0.27及后续版本升级了底层libgit2库，引入了安全目录检查机制。对于无主目录的Windows系统用户（非交互式），该机制的配置读取逻辑和权限判断存在特殊场景，仅在仓库级.git/config添加[safe] directory = *无法覆盖全局检查规则。

解决步骤 #

1. 添加系统级Git配置 #

Windows系统级Git配置通常位于C:\Program Files\Git\etc\gitconfig（对应官方Git安装包），如果是LibGit2Sharp自带的libgit2环境，可自行创建一个系统级配置文件，添加以下内容：

[safe]
    directory = *

若想更安全，可指定具体仓库路径（注意Windows路径转义）：

[safe]
    directory = C:\\your\\repo\\path

2. 手动指定全局配置路径给LibGit2Sharp #

由于系统用户无$HOME目录，LibGit2Sharp可能无法自动识别全局配置位置。初始化Repository时，通过RepositoryOptions显式指定：

var repoOptions = new RepositoryOptions
{
    GlobalConfigurationLocation = @"C:\path\to\your\system\gitconfig"
};

using (var repo = new Repository(pathToRepo, repoOptions))
{
    // 业务逻辑代码
}

3. 临时禁用安全目录检查（仅用于验证） #

若需快速验证问题根源，可通过配置关闭安全检查（不推荐生产环境使用，存在安全风险）：

var repoOptions = new RepositoryOptions
{
    EnableSafeDirectoryCheck = false
};

using (var repo = new Repository(pathToRepo, repoOptions))
{
    // 业务逻辑代码
}

注：该选项仅在较新的LibGit2Sharp版本中提供，若当前版本无此属性，需升级至最新版。

4. 验证仓库目录所有者权限 #

即使进程有读写权限，Windows文件系统的所有者标识可能与系统用户不匹配。以系统用户身份执行以下命令检查：

icacls "C:\your\repo\path"

确保系统用户是目录的所有者，或拥有足够的权限通过libgit2的所有者校验。

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