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：

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

# word # git # github # access # ai # c# # .net # lsp # red # 命名空间 # Token # 接口 # using # visual studio # https # ssh

返回目录在线咨询

上一篇：php 如何设置一个严格控制过期时间的session
下一篇：建站市场备案服务号：如何快速完成网站备案？

您的项目需求