C# 如何克隆一个Git仓库 - LibGit2Sharp库的使用

来源:这里教程网 时间:2026-02-21 17:32:43 作者:

使用 LibGit2Sharp 克隆 Git 仓库,核心是调用

Repository.Clone()
方法。它支持 HTTPS、SSH、本地路径等多种 URL,也支持带认证、自定义选项的克隆。

安装 LibGit2Sharp

通过 NuGet 安装最新稳定版(注意:.NET 6+ 推荐用 v0.27.0+):

Visual Studio:NuGet 包管理器中搜索
LibGit2Sharp
并安装
命令行:
dotnet add package LibGit2Sharp

安装后引用命名空间:

using LibGit2Sharp;

最简克隆(HTTPS,无认证)

一行代码即可完成基础克隆:

Repository.Clone("https://github.com/user/repo.git", @"C:\my-repo");

执行后会在指定路径创建完整工作目录,包含

.git
和所有文件。

带用户名密码的 HTTPS 克隆

需构造

CloneOptions
并传入
CredentialsProvider

var options = new CloneOptions
{
    CredentialsProvider = (url, user, cred) => new UsernamePasswordCredentials
    {
        Username = "your-username",
        Password = "your-personal-access-token" // GitHub 推荐用 PAT,非密码
    }
};
Repository.Clone("https://github.com/private/repo.git", @"C:\private-repo", options);

⚠️ 注意:GitHub 已禁用账户密码登录,必须使用 Personal Access Token (PAT) 替代密码。

克隆时控制行为(深度、分支、裸仓库等)

通过

CloneOptions
可精细配置:

CheckoutBranch = false
:只下载 .git,不检出工作目录(类似
git clone --no-checkout
IsBare = true
:创建裸仓库(无工作区,适合服务端)
Depth = 1
:浅克隆(仅最新提交,节省时间和空间)
BranchName = "dev"
:指定克隆并检出特定分支

示例(浅克隆 main 分支,不自动检出):

var options = new CloneOptions
{
    BranchName = "main",
    Depth = 1,
    CheckoutBranch = false
};
Repository.Clone("https://github.com/user/repo.git", @"C:\shallow-repo", options);

基本上就这些。LibGit2Sharp 的克隆接口简洁直接,关键在按需配置

CloneOptions
和认证方式。注意权限、网络代理和路径权限问题,常见报错多源于认证失败或目标目录非空。

相关推荐