我们经常发布文档更新，此页面的翻译可能仍在进行中。有关最新信息，请访问英文文档。如果此页面上的翻译有问题，请告诉我们。
简体中文
未找到结果.

按产品浏览

Repositories
  • Get started
  • Account and profile
  • Authentication
  • Repositories
  • GitHub
  • Enterprise administrators
  • Billing and payments
  • Organizations
  • Code security
  • GitHub Issues
  • GitHub Actions
  • GitHub Codespaces
  • GitHub Packages
  • Search on GitHub
  • Developers
  • REST API
  • GraphQL API
  • GitHub CLI
  • GitHub Discussions
  • GitHub Sponsors
  • Building communities
  • GitHub Pages
  • Education
  • GitHub Desktop
  • Atom
  • Electron
  • CodeQL
  • npm
    • 简体中文
  • English
  • 简体中文 (Simplified Chinese)
  • 日本語 (Japanese)
  • Español (Spanish)
  • Português do Brasil (Portuguese)

    • 此版本的 GitHub Enterprise 已停止服务 2021-09-23. 即使针对重大安全问题，也不会发布补丁。 要获得更好的性能、改进的安全性和新功能，请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助，请联系 GitHub Enterprise 支持。

    Article version

    本文内容

    排查克隆错误

    If you're having trouble cloning a repository, check these common errors.

    HTTPS 克隆错误

    对 Git 使用 HTTPS 时有几种常见错误。 这些错误通常表示您有旧版 Git，或无法访问仓库。

    下面是您可能收到的 HTTPS 错误示例：

    > error: The requested URL returned error: 401 while accessing
> https://主机名/user/repo.git/info/refs?service=git-receive-pack
> fatal: HTTP request failed
    > Error: The requested URL returned error: 403 while accessing
> https://主机名/user/repo.git/info/refs
> fatal: HTTP request failed
    > Error: https://主机名/user/repo.git/info/refs not found: did you run git
> update-server-info on the server?

    检查 Git 版本

    与 GitHub Enterprise Server 交互没有最低 Git 版本要求，但我们发现 1.7.10 版是一个方便、稳定的版本，适用于许多平台。 您可随时在 Git 网站上下载最新版本。

    确保远程正确

    您要提取的仓库必须存在于 您的 GitHub Enterprise Server 实例 上，且 URL 区分大小写。

    您可以打开命令行并输入 git remote -v 来查找本地仓库的 URL：

    $ git remote -v
# View existing remotes
> origin  https://github.com/ghost/reactivecocoa.git (fetch)
> origin  https://github.com/ghost/reactivecocoa.git (push)

$ git remote set-url origin https://github.com/ghost/ReactiveCocoa.git
# Change the 'origin' remote's URL

$ git remote -v
# Verify new remote URL
> origin  https://github.com/ghost/ReactiveCocoa.git (fetch)
> origin  https://github.com/ghost/ReactiveCocoa.git (push)

    也可通过 GitHub Desktop 应用程序更改 URL。

    提供访问令牌

    要访问 GitHub，您必须使用个人访问令牌而不是密码进行身份验证。 更多信息请参阅“创建个人访问令牌”。

    检查您的权限

    提示输入用户名和密码时，确保使用可以访问仓库的帐户。

    提示：如果不想在每次与远程仓库交互时都输入用户名和密码，您可以打开凭据缓存。 如果已在使用凭据缓存，请确保您的计算机缓存了正确的凭据。 不正确或过期的凭据将导致身份验证失败。

    改用 SSH

    如果您以前设置了 SSH 密钥，便可使用 SSH 克隆 URL，而不使用 HTTPS。 更多信息请参阅“关于远程仓库”。

    错误：未找到仓库

    如果您在克隆仓库时看到此错误，意味着仓库不存在、您没有访问权限，或者 您的 GitHub Enterprise Server 实例 处于隐私模式。 对此错误有一些解决办法，具体取决于错误原因。

    检查拼写

    拼写错误可能发生，并且仓库名称区分大小写。 如果您尝试克隆 git@<em>主机名</em>:user/repo.git，但仓库实际被命名为 User/Repo，您会收到此错误。

    要避免此错误，克隆时，始终从仓库页面复制和粘贴克隆 URL。 更多信息请参阅“克隆仓库”。

    要在现有仓库上更新远程，请参阅“管理远程仓库”。

    检查权限

    如果您尝试克隆私有仓库，但没有查看仓库的权限，您将收到此错误。

    确保您通过以下方式之一中，拥有仓库的访问权限：

    检查 SSH 访问权限

    在极少数情况下，您可能没有仓库的适当 SSH 访问权限。

    您应确保正在使用的 SSH 密钥已连接到您的 GitHub Enterprise Server 用户帐户。 您可以通过在命令行中输入以下内容检查此项：

    $ ssh -T git@主机名
> Hi username! You've successfully authenticated, but GitHub does not
> provide shell access.

    如果仓库属于组织，并且您使用的是 OAuth App 生成的 SSH 密钥，则 OAuth App 访问权限可能已被组织所有者限制。 更多信息请参阅“关于 OAuth App 访问限制”。

    更多信息请参阅添加 SSH 密钥到 GitHub 帐户。

    检查实例是否处于私有模式

    如果您的站点管理员已对您的 GitHub Enterprise 实例启用私有模式，将禁用通过 git:// 进行匿名克隆。 如果您无法克隆仓库，请联系您的站点管理员。

    检查仓库是否确实存在

    如果所有其他内容失败，确保仓库在 您的 GitHub Enterprise Server 实例 上确实存在！ 如果您尝试推送不存在的仓库，您将收到此错误。

    错误：远程 HEAD 引用不存在的 ref，无法检出

    如果已在 您的 GitHub Enterprise Server 实例 上删除仓库的默认分支，会发生此错误。

    检测此错误很简单；当您尝试克隆以下仓库时，Git 会警告您：

    $ git clone https://主机名/user/repo.git
# Clone a repo
> Cloning into 'repo'...
> remote: Counting objects: 66179, done.
> remote: Compressing objects: 100% (15587/15587), done.
> remote: Total 66179 (delta 46985), reused 65596 (delta 46402)
> Receiving objects: 100% (66179/66179), 51.66 MiB | 667 KiB/s, done.
> Resolving deltas: 100% (46985/46985), done.
> warning: remote HEAD refers to nonexistent ref, unable to checkout.

    要修复此错误，您需要成为 您的 GitHub Enterprise Server 实例 上仓库的管理员。 您需要更改仓库的默认分支。

    之后，您可以从命令行获取所有可用分支的列表：

    $ git branch -a
# Lists ALL the branches
>   remotes/origin/awesome
>   remotes/origin/more-work
>   remotes/origin/new-master

    然后，您可以切换到新分支：

    $ git checkout new-master
# Create and checkout a tracking branch
> Branch new-master set up to track remote branch new-master from origin.
> Switched to a new branch 'new-master'
> Switched to a new branch 'new-main'