跳到主要内容

Git 操作常见问题

Git 是什么？如何使用 Git 提交代码到 Gitee？​

点击 了解 Git 的基础信息，

点击 了解使用 Git 提交代码到 Gitee

Git 客户端推送代码提示 fatal: Authentication failed？​

原因：权限受限

解决步骤：

  • 通过 https 方式：请再次检验下您的账号和密码是否输入无误，或者您当前账号对于该仓库来说是没有 push 权限的。
  • 通过 SSH 方式：敬请检查是否配置 ssh 公钥，并将其部署在 Gitee 上。

为什么在 push 的时候，出现了 413 错误，push 失败​

当 Git 使用 HTTP 进行推拉时，受限于 HTTP 协议无状态的设计限制，Git HTTP Server 会对请求数据包做一个长度限制，在 Git 客户端上具体表现为 Git 的 http.postBuffer 配置项。

为了提供更稳定更快的服务，Gitee 的 HTTP 服务器配置了 单次上传大小限制（client_max_body_size） 为 500M，如果在本地推送代码单次 Push 超过 500M，将被服务器拒绝，返回 413 错误。

当推送代码遇到返回 413 错误时，可尝试以下配置命令，将本地 http.postBuffer 数值调整到 Gitee 服务对应的单次上传大小配置：

git config --global http.postBuffer=524288000

使用 SSH 进行代码推拉可以避免该问题 ，具体使用方式请参考：《使用 SSH 方式推拉代码》

Permission denied (publickey)​

原因：无目标仓库和分支的权限，导致无法更新数据。

解决步骤：

  1. 检查 push 方式
    • SSH 方式：检查 SSH 公钥是否正确（多个私钥时，请使用 ssh-add 命令来指定默认使用的私钥）；
    • HTTPS 方式：请检查密码及用户名是否正确。
  2. 确认对目标分支是否有写权限。

clone 代码报 RPC failed​

原因：HTTPS 的 http.postBuffer 对推送文件大小有限制造成的。

解决步骤：更换 SSH 方式进行推送。

Couldn’t resolve host​

原因：DNS 设置问题造成域名无法正常解析。

解决步骤：请更换您的 DNS 为 8.8.8.8 或 114.114.114.114 后重启网络。

clone 代码报 403 错误​

原因：权限受限、仓库地址错误、缓存错误密码

解决步骤：

  1. 保证 remote url（大小写敏感）正确
  2. 保证自己在仓库中的权限不受限
  3. https clone 提示 403 且不提示输入密码，则 git 客户端缓存了错误的密码，请清除已保存的密码。
  4. 换用 SSH 地址 clone

Gitee 的代码管理支持图形化工具吗？​

支持，我们推荐使用如下 Git 客户端、IDE 以及浏览器插件工具，具体请阅读 Git 大全。