# FAQ

## 多个代码仓存在编译依赖时如何同时发起构建<a name="section169732563435"></a>

OS\(操作系统\)开发时，经常会遇到多个代码仓的修改具有编译依赖关系，需要同时构建、同时合入。为此码云平台将Issue作为具有编译依赖的多个代码仓提交PR的关联标识。具体操作如下：

1. 在此次提交的任意一个代码仓上创建Issue。

2. 将多个需要同时构建、同时合入的PR关联上述Issue，具体操作请参考码云帮助中心：[https://gitee.com/help/articles/4142](https://gitee.com/help/articles/4142)。

3. 触发构建\(详见触发构建的操作帮助\)后，构建中心会识别关联了同一Issue的PR，同时下载构建，并在代码审核通过后，同时进行合并入代码库。

## `Signed-off-by`相关操作<a name="section-signed-off"></a>

### 如何在Commit中添加signoff记录

使用`git commit -s` 或 `git commit –signoff` 命令提交。

### 如何追加signoff到上一次commit?

执行`git commit --amend --signoff`命令 。

关于commit更多选项，请参考：[https://](https://git-scm.com/docs/git-commit)[git-scm.com/docs/git-commit](https://git-scm.com/docs/git-commit)

## DCO校验异常处理<a name="section-dco"></a>

开发者提交Pull Request后，评论`start build`会触发门禁校验：

1. 该PR提交是否签署Developer Certificate of Origin（DCO) “开发者原创声明”。
2. 该PR提交是否包含 Signed-off-by信息。

校验失败可能的原因有：

1. 未签署“DCO协议”，例如提示：

   ```
   当前检测到如下commit的用户未签署DCO协议：
   
   •345612
   
   •213123
   ```

   **解决办法**：

   点击[这里](https://dco.openharmony.cn/sign)签署、查看签署状态。

   在PR的评论框输入`check dco`后，单击”评论”，系统将再次进行DCO校验。

2. Commits 中未包含 Signed-off-by信息，例如提示：

   ```
   当前检测到如下commit未包含Signed-off-by信息：
   
   •123123
   
   •345612
   ```

   **解决办法**：

   参考`Signed-off-by`相关操作，添加Signed-off-by信息。格式为：Signed-off-by: user.name <user.email>。

   在PR的评论框输入`check dco`后，单击”评论”，系统将再次进行DCO校验。

3. 网页端/WebIDE提交PR的邮箱地址与签署DCO协议使用的邮箱地址不一致。

   
   **解决办法**：

   在Gitee的“设置 > 邮箱管理”中，查询提交邮箱设置是否准确。确保提交邮箱与签署DCO使用的邮箱地址一致。

   > **说明：**
   > 
   > 如果在邮箱管理页面中，勾选了“不公开我的邮箱地址”，默认会生成一个xxxx@user.noreply.gitee.com的邮箱作为PR提交邮箱。如果需要使用其他邮箱作为提交邮箱，需要取消勾选“不公开我的邮箱地址”。

## 回退提交<a name="section479422315253"></a>

请参考码云帮助中心：[https://gitee.com/help/articles/4195](https://gitee.com/help/articles/4195)

## 处理冲突<a name="section94417232274"></a>

请参考码云帮助中心：[https://gitee.com/help/articles/4194](https://gitee.com/help/articles/4194)

## 门禁检测问题处理

| 门禁检查项  |  常见报错信息 |
| ------------ | ------------ |
| [API参考链接跳转锚点准确](/spec/markdown-check/api-reference-link-check)  | 1. 链接名称在标题及标题下表格均不存在 <br>2. 链接名称不准确 <br>3. 检测到链接名称与目标页面标题不一致 |
| [有序列表格式](/spec/markdown-check/md-style-check#有序列表格式)  | 序列号格式异常 |
| [代码块格式](/spec/markdown-check/md-style-check#代码块格式)  | 代码块格式错误  |
| [代码块缩进格式](/spec/markdown-check/md-style-check#代码块缩进格式)  | 代码块缩进异常  |
| [代码块未指定语言提示](/spec/markdown-check/md-style-check#代码块未指定语言提示)  | 代码块未指定语言  |
| [表格格式](/spec/markdown-check/md-style-check#表格格式)  | 1. 存在制表符<br>2. 表格至少需要三行（标题行、分隔符行和数据行）<br>3. 标题行格式不正确，存在空列<br>4. 标题行格式不正确<br>5. 缺少标题行<br>6. 缺少分隔符行、或分隔符行格式不正确<br>7. 标题行和分隔符行的列数不一致<br>8. 数据行格式不正确，存在空列<br>9. 数据行格式不正确<br>10. 数据行的列数与标题行不一致  |
| ["说明"，"注意"格式规范](/spec/markdown-check/md-style-check#说明注意格式规范)  | 1. 表格中错误：第xxx行表格总说明或注意格式不符合写作规范<br>2. 正文中错误：第xxx行提示语错误；错误信息：  |
| [HTML标签规范](/spec/markdown-check/md-style-check#html标签规范)  |  1. 第xxx行br错误<br>2. 第xxx行sup错误 |
| [@link异常检测](/spec/markdown-check/md-style-check#link异常检测)  | 第xxx行链接错误；错误信息  |
| [链接（图片链接）格式错误](/spec/markdown-check/md-style-check#链接图片链接格式错误)  | 链接格式错误  |
| [标题存在序号](/spec/markdown-check/md-style-check#标题存在序号)  | 标题中有序号  |
| [示例代码中不可使用console.log](/spec/markdown-check/md-style-check#示例代码中不可使用consolelog)  | 日志打印方式错误；不可使用console.log进行日志打印。 |
| [代码注释符](/spec/markdown-check/md-style-check#代码注释符)  | 代码注释格式异常 |
| [JSON/JSON5代码格式检查](/spec/markdown-check/md-style-check#jsonjson5代码格式检查)  | json代码块中格式存在异常，请将代码块放置在IDE中进行确认处理。 |
| [段落格式](/spec/markdown-check/md-style-check#段落格式)  |  段落之间需要存在空行  |
| [urlpath检查](/spec/markdown-check/md-style-check#readme中urlpath检查)  |  urlpath格式检查  |

<!--no_check-->