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