常见问题

提示验证失败怎么办？

在克隆代码仓库时需输入服务邮箱与服务密码。你可以前往「个人账户设置」 -> 「个人设置」查看服务凭证。

克隆代码时出错怎么办？

1. 请确保安装并使用了最新版官方 Git 客户端。
2. 在终端中输入命令 git remote -v 查询所关联的 remote url （大小写敏感）是否为正确的：

若 remote url 有误，请参考一下命令行修改远程仓库地址。

$ git remote set-url origin https://git.coding.net:username/right-name.git

推送代码时提示其他错误怎么办？

请参考 快速开始 确保你执行了正确的操作。如果仍然报错请 提交工单 ，并在工单中附上以下信息（可选）：

3. Git 报错信息
4. 执行 git –version 的结果
5. 其他可能有用的信息，例如输入 ping coding.net 命令后的运行结果、你目前的 IP 地址及所使用的 DNS 等

提示 Couldn’t resolve host 怎么办？

这可能是由于你的 DNS 设置造成的，请更换你的 DNS 为 114.114.114.114 或 1.1.1.1 后重启网络。

提示 RPC failed 错误怎么办？

这是由于 HTTPS 推送方式的 http.postBuffer 限制推送文件大小。可以在终端中执行 git config http.postBuffer 524288000 命令以设置更大的限制值，或者切换为 SSH 方式进行推送。

若返回错误码： HTTP 403 curl 22 The requested URL returned error: 403 Forbidden ，还可以检查是否具备仓库访问权限、账号密码是否正确、仓库存储是否已满。

如何修改已关联的外部仓库？

以修改已关联的 GitHub 仓库为例：

6. 登录 GItHub，点击右上角头像处的【Settings】>【Applications】>【Authorized OAuth Apps】 取消关联。

7. 登录新的 GitHub 账号。

8. 返回 CODING 的代码仓库，点击「关联仓库」后重新刷新 GitHub OAuth 认证。

   认证失败超过 20 次提示冻结 3600s 怎么办？

   

   使用错误的凭据连续认证失败累计 20 次将触发安全保护机制，暂时冻结该仓库的 https 访问，需要暂时停止所有自动或者手动认证的动作，等待冻结时间结束后重新进行登录，否则即使使用正确的账号密码也会认证失败并导致冻结时间重置。

   若需紧急进行代码操作，你也可以改为 SSH 协议进行代码推拉。

   公钥拉取失败提示 Permission denied(publickey)

   可能是由于你没有目标仓库和分支的权限，导致无法更新数据。确认对目标分支已有读写权限后依然出现此错误码，请参考以下解决办法。

   1. 本地单公钥

   删除本地的公钥与私钥后，根据 指引 提示重新生成新的公钥与私钥，并将新的公钥重新添加至项目中。

   2. 本地存在多公钥

   在 ~/.ssh 目录下参考下列样例新建 config 文件：

   Host "demo1"
           HostName "code.csdn.net"
           User "git"
           IdentityFile "C:/Users/your-name/.ssh/id_rsaDemo1"
   Host "demo2"
           HostName "code.csdn.net"
           User "git"
           IdentityFile "C:/Users/your-name/.ssh/id_rsaDemo2"

   例如目标仓库的 git 地址为： [email protected]:example/example.git ，那么可以使用 git clone git@demo1:your-name/demo1.git 命令进行拉取。针对不同的目标仓库，修改命令中的别名完成拉取。

   3. RSA 算法被禁用

   此问题通常发生在 Git 客户端是 v2.33.1 及以上的版本或者 OpenSSH 是 8.8 及以上用户群体中。你可以添加 ~/.ssh/config 文件并使用 vim ~/.ssh/config 命令重新修改 ssh-rsa 配置。

   Host e.coding.net
   HostkeyAlgorithms +ssh-rsa
   PubkeyAcceptedAlgorithms +ssh-rsa

   使用新算法生成新的公私钥： ssh-keygen -t ed25519 -C "your email" 。

   部署公钥与个人公钥有何区别？

   部署公钥归项目所有，配置后默认拥有该项目的只读权限（可以调整为读写权限），能够添加至多个项目中；个人公钥归个人所有，配置后拥有账户下所有项目的读写权限，常用于认证 OPEN API 鉴权。同一份公钥不能既作为部署公钥，又配置为个人公钥。

   代码仓库满了怎么办？

   • 标准版团队的单仓库容量限额为 1 GB
   • 高级版团队的单仓库容量限额为 5 GB
   • 旗舰版团队的单仓库容量限额为 20 GB

   你可以点击右上角的”服务订购“升级团队。

   或者使用 Git LFS 命令 管理大文件、亦或是将大容量仓库拆分为各个小仓库。

   • 标准版团队的 LFS 容量限额为 5 GB
   • 高级版团队的 LFS 容量限额为 100 GB
   • 旗舰版团队的 LFS 容量限额为 500 GB

   Git 账号密码相关

   问题描述： 每次提交代码后需要反复进行账号与密码验证、无法删除仓库缓存中的账号与密码。

   解决办法：

   方法一： 切换为 SSH 协议。

   使用 SSH 协议进行代码推拉不仅是更加安全的方式，也能够避免频繁输入账号密码。你可以参考此 文档 生成 SSH 公钥后将其上传至代码仓库中作为部署公钥。

   在本地终端中使用命令 git remote repo-url ，再输入 git remote -v 以验证是否生效。

   生效后即可免密进行代码推拉。若更换 ssh 密钥，请重新上传至代码仓库中。

   方法二： 删除缓存中的账号密码并重新录入正确的账号与密码。

   macOS：

   多数情况下 macOS 采用 osxkeychain（钥匙串）工具保存 Git 账号密码，前往“钥匙串访问”，搜索以 e.coding.net 开头的钥匙串并删除。

   删除账号与密码后，重新推送或拉取代码，此时会提醒您输入正确的账号与密码，无误后系统将会记住新的账号与密码。若仍未删除成功，在终端中运行此命令：

   git credential-osxkeychain erase
   host=e.codingcorp.net
   protocol=https

   删除后重新推送或拉取代码，按照提示输入新的账号与密码。

   Git 账号密码将同时保存在钥匙串与 .git-credential 文件中。若删除钥匙串后依然提示密码错误，有可能是系统读取了 .git-credential 文件中的账号与密码。

   Windows:

   • 点击“设置”后，前往控制面板中的“用户账户”。

   • 在普通凭据中搜索以 e.coding.net 命名的普通凭据。

   • 删除凭据后，重新推送或拉取代码，按照提示录入正确的账号与密码。

     导入仓库后没有合并请求记录如何处理？

     目前仅支持导入代码仓库中的代码资源、版本号与提交记录。合并请求记录存储于 git 客户端数据库中，此部分信息无法被导入。

     创建合并请求时提示不可自动合并怎么办？

     

     出现此错误的原因是两个分支中的代码存在冲突。你可以在本地终端中，在源分支执行 git merge [target branch] 命令查看所有冲突文件。依次解决所有冲突后，重新提交一个 commit 至远端仓库合并请求将自动变更为“可合并”状态。

     代码提交失败，并提示仓库使用量之和已达到 5G 该怎么办？

     标准版团队的总代码仓库容量限额调整为 5 GB，超过此容量限制后将无法继续推送代码。您需要联系团队负责人 / 管理员升级团队版本或单独购买高性能包以提升团队总代码容量，点击查看最新的 服务方案与计费 。

     导入外部开源仓库时失败怎么办？

     导入外部开源仓库但提示失败，可能是因为团队开启了“提交者和提交作者必须为已验证邮箱”限制。联系团队所有者 / 管理员，前往团队设置中心的“仓库设置”中取消此限制后再重新导入外部开源仓库。

     如何查看代码仓库容量？

     你可以分别在团队首页、代码仓库设置页、团队设置中心页查看代码仓库容量。

     团队首页：

     访问代码仓库列表页，点击目标代码仓库右侧的齿轮按钮。

     勾选仓库容量按钮后即可批量查看代码仓库中的剩余容量。

     代码仓库设置页：

     访问任意代码仓库中的“设置”页，在仓库基本设置中将展示当前代码仓库中的容量。

     团队设置中心：

     团队所有者 / 管理员点击团队首页左侧的“团队设置中心”，点击“全局设置”页中的“资源用量”按钮。

     在此处你可以看到团队中已使用的 Git 仓库容量、Git LFS 总容量。

     如何提升代码质量？

     DevOps 理念提倡代码质量内建，旨在确保提交入库的代码都是合格的。要想提升入库代码质量，一方面可以基于 CODING 代码扫描功能确保代码质量和安全；另一方面是建立良好的研发规范和协作流程，例如代码 Review 和质量检查，将不合规代码拦截于库外，稳步提升代码质量。

     代码存储在本地机房相较于上传至 CODING 中有何区别？

     1. 使用研发度量时不支持外部代码统计。
     2. 代码扫描功能模块暂不支持外部仓库，你需要调用 CI 中的代码扫描插件以满足需求。
     3. 无法将外部代码的提交信息与事项相关联。
     4. 外部仓库 GitLab 的 OAuth 认证会过期，需定期手动刷新 OAuth 认证。

     网络正常，但是导入外部仓库失败怎么办？

     除去网络因素，若在团队设置中心开启推送限制或分支规范亦有可能导致外部仓库导入失败。

     解决办法：

     5. 检查团队设置中心中的仓库设置，取消勾选所有限制。
     6. 检查团队设置中心中的仓库规范，取消勾选“创建仓库时默认勾选仓库规范方案”选项。

     推送代码时提示不是有效的 CODING 邮箱，如何处理？

     问题详情：

     推送代码时出现下图错误：

     解决办法：

     这是因为团队设置中心开启了推送限制（如下图所示），并且当前成员所使用的代码提交者邮箱并未在个人账户设置中进行验证，因此将拦截推送。

     你可以在本地终端中运行 git config --list 命令查看当前代码仓库中的提交者邮箱。若发现当前提交者邮箱并非个人设置中的邮箱，那么需要将已验证邮箱设置为本地代码仓库中的提交邮箱。参考 《个人邮箱设置》 验证代码提交者邮箱。

     在终端中运行 git config user.email "已在 COIDNG 验证的邮箱" 命令替换提交者邮箱，验证完成后即可顺利推送。

     项目归档后，代码仓库是否占用团队仓库容量？

     归档项目中的代码仓库依然会占用团队仓库容量。

     如何查看代码贡献图？

     CODING 代码贡献图参考如下：

     前往任意代码仓库，点击“提交”选项中的成员姓名即可查看当前成员的代码贡献图。

     为什么代码提交列表中的成员名并非团队成员的名字？

     代码提交中的成员名称取决于推送者在本地仓库 git config 文件中所设置的 user.name 与 user.email 参数，你可以通过 git conifg --list 命令检查。

     7. 当 user.email 参数中填写了 CODING 邮箱时，就会显示该邮箱对应的团队成员名。

     8. 当 user.email 参数中填写了非 CODING 邮箱时，将显示 git config 文件中设置的 user.name 名称。

        代码仓库删除后，为什么对应的部署公钥未删除？

        代码仓库删除后将暂存至回收站，保留 30 天后数据才会彻底删除。你可以先恢复此仓库，然后前往仓库设置手动删除相关部署公钥后再删除仓库。

        代码仓库删除后，为什么团队仓库容量没有及时恢复？

        代码仓库删除后将暂存至回收站，保留 30 天后数据才会彻底删除。你可以选择在仓库设置中重置代码仓库及时恢复仓库容量。

        为什么删除仓库时无法点击确认删除按钮？

        删除代码仓库时需输入两条信息：

     9. 代码仓库名称
     10. CODING 账号登录密码

     请检查是否输入了代码仓库名称。

     代码托管在 CODING 是否安全？

     这个问题涉及两个层面，一是代码托管至云端是否安全，二是代码托管至 CODING 是否安全。

     11. 相较于把代码上云，将代码放在本地是否就安全呢？

         代码放在本地，首先需要搭建一套代码管理系统配有专人维护，并且还需辅以建设安全机制，保障服务稳定和数据的安全性，以上两项都有一定的技术要求和较高的成本支出；

         专业的人负责专业的事。代码托管托管在具备技术实力和安全保障的专业云服务商上，在保障代码安全的基础时还能够使用更多功能，享受专业的服务，更加省时省力省钱；

         国内企业 SaaS 服务经过多年发展，企业将人力信息、财务信息、客户信息、产品部署都放在云服务商，对于中小企业来说，选择一家有技术安全实力的云服务提供商比自己搭建一套系统更加安全高效。

     12. 代码托管到 CODING 是否安全呢？

         CODING 是目前国内市场上唯一基于企业级 Java 技术完全自主研发的一站式软件研发平台，相比其它基于开源项目改造的更加安全、可控性更高。同时具备更强的扩展性，不容易受到被公开的漏洞攻击。

         网站通信采用 HTTPS 协议，代码推拉采用 HTTPS 或 SSH 协议，全程加密传输数据，避免数据传输过程中的泄漏；

         可设置成员权限，可锁定异常成员，访问资源都须经用户 OAuth 认证，有效控制企业资源的访问权限；

         提供二次验证、密码规则设置等功能，可以有效防止由团队成员账号遗失或被盗导致的团队信息泄漏风险；

         提供详细的操作日志，可通过记录追溯团队成员的操作行为，可及时发现异常操作；

         具有完善的运维安全机制，点击了解 详情 。

         架构设计高可用。代码仓库使用分区存储策略存放于不同的存储服务器上，将其挂载到计算服务器工作空间上，相互之间不产生影响。若单点故障，负载会自动分配到其他服务器上。单个代码仓库出现问题后，仅需恢复此仓库的数据即可，其他仓库不受影响。

         在客户环境满足的情况下，CODING 可以提供卓越的高可用能力，保证代码的安全性。

         代码仓库支持硬盘 Raid、全程加密传输、定时备份、实时备份等多种手段保证代码的安全，最大程度降低代码管理风险。
         为收费服务，收费服务意味着契约精神，CODING 有责任保障客户的代码及相关资产的安全；

         自 2014 年运营至今，服务了 300 万研发团队与数万家企业用户，未出现信息泄漏的事件，在业内中拥有良好的口碑和信誉；