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

使用 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：

察言观数AskTable

企业级ai数据表格智能体平台

72

查看详情

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