使用 LibGit2Sharp 克隆 Git 仓库需调用 Repository.Clone() 方法,支持 HTTPS、SSH 等多种协议;通过 CloneOptions 可配置认证、深度、分支、裸仓库等选项,注意 GitHub 需用 PAT 替代密码。

使用 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 和认证方式。注意权限、网络代理和路径权限问题,常见报错多源于认证失败或目标目录非空。










