Skip to main content

创建议题表单时的常见验证错误

创建、保存或查看问题表单时,可能会看到其中一些常见验证错误。

注意: 问题表单目前为 beta,可能随时更改。

缺少必需的顶级键 name

模板不包含 name 字段,这意味着在向用户提供选项列表时,不清楚要调用问题模板的内容。

“缺少所需的顶级键 name”错误的示例

description: "Thank you for reporting a bug!"
...

可以通过添加 name 作为键来修复此错误。

name: "Bug report"
description: "Thank you for reporting a bug!"
...

key 必须是字符串

此错误消息表示已提供允许的键,但由于不支持数据类型,无法分析其值。

key 必须是字符串”错误的示例

下面的 description 被分析为布尔值,但它应该是字符串。

name: "Bug report"
description: true
...

可以通过提供字符串作为值来修复此错误。 可能需要在字符串两侧加双引号才能成功分析。 例如,必须在包含 ' 的字符串两侧加双引号。

name: "Bug report"
description: "true"
...

当字段应为字符串时,也不允许使用空字符串或仅包含空格的字符串。

name: ""
description: "File a bug report"
assignees: "      "
...

可以通过将值更正为非空字符串来修复此错误。 如果字段不是必需的,则应删除键值对。

name: "Bug Report"
description: "File a bug report"
...

input 不是允许的键

模板的顶层提供了意外的键。 有关支持哪些顶级键的详细信息,请参阅“议题表单的语法”。

input 不是允许的键”错误的示例

name: "Bug report"
hello: world
...

可以通过删除意外的键来修复此错误。

name: "Bug report"
...

禁止键

YAML 将某些字符串分析为 Boolean 值。 为了避免这种情况,我们明确禁止使用以下键:

yYyesYesYESnNnoNoNOtrueTrueTRUEfalseFalseFALSEonOnONoffOffOFF

可以通过删除禁止键来修复此错误。

正文必须至少包含一个非 markdown 字段

问题表单必须接受用户输入,这意味着它的至少一个字段必须包含用户输入字段。 markdown 元素是静态文本,因此 body 数组不能只包含 markdown 元素。

“正文必须至少包含一个非 markdown 字段”错误的示例

name: "Bug report"
body:
- type: markdown
  attributes:
    value: "Bugs are the worst!"

可以通过添加接受用户输入的非 markdown 元素来修复该错误。

name: "Bug report"
body:
- type: markdown
  attributes:
    value: "Bugs are the worst!"
- type: textarea
  attributes:
    label: "What's wrong?"

正文必须具有唯一 ID

如果使用 id 属性来区分多个元素,则每个 id 属性必须是唯一的。

“正文必须具有唯一 ID”错误的示例

name: "Bug report"
body:
- type: input
  id: name
  attributes:
    label: First name
- type: input
  id: name
  attributes:
    label: Last name

可以通过更改其中一个输入的 id,使每个 input 字段都具有唯一的 id 属性来修复该错误。

name: "Bug report"
body:
- type: input
  id: name
  attributes:
    label: First name
- type: input
  id: surname
  attributes:
    label: Last name

正文必须具有唯一标签

当有多个接受用户输入的 body 元素时,每个用户输入字段的 label 属性必须是唯一的。

“正文必须具有唯一标签”错误的示例

name: "Bug report"
body:
- type: textarea
  attributes:
    label: Name
- type: textarea
  attributes:
    label: Name

要修复该错误,可以更改其中一个输入字段的 label 属性,确保每个 label 都是唯一的。

name: "Bug report"
body:
- type: textarea
  attributes:
    label: Name
- type: textarea
  attributes:
    label: Operating System

输入字段也可以按其 id 属性进行区分。 如果需要重复的 label 属性,则可以提供至少一个 id 来区分具有相同标签的两个元素。

name: "Bug report"
body:
- type: textarea
  id: name_1
  attributes:
    label: Name
- type: textarea
  id: name_2
  attributes:
    label: Name

id 属性在问题正文中不可见。 如果要区分生成的问题中的字段,则应使用不同的 label 属性。

标签太相似

相似的标签可以处理成相同的引用。 如果没有为 input 提供 id 属性,则 label 属性用于生成对 input 字段的引用。 为此,我们将利用 Rails 参数化方法来处理 label。 在某些情况下,可以将两个不同标签处理为相同的参数化字符串。

“标签太相似”错误的示例

name: "Bug report"
body:
- type: input
  attributes:
    label: Name?
- type: input
  id: name
  attributes:
    label: Name???????

可以通过将至少一个区别性字母数字字符(-_)添加到冲突标签之一来修复该错误。

name: "Bug report"
body:
- type: input
  attributes:
    label: Name?
- type: input
  attributes:
    label: Your name

也可以通过为其中一个冲突标签提供唯一的 id 来修复该错误。

name: "Bug report"
body:
- type: input
  attributes:
    label: Name?
- type: input
  id: your-name
  attributes:
    label: Name???????

复选框必须具有唯一标签

当存在 checkboxes 元素时,它的每个嵌套标签在其对等方以及其他输入类型中都必须是唯一的。

“复选框必须具有唯一标签”错误的示例

name: "Bug report"
body:
- type: textarea
  attributes:
    label: Name
- type: checkboxes
  attributes:
    options:
    - label: Name

可以通过更改其中一个输入的 label 属性来修复该错误。

name: "Bug report"
body:
- type: textarea
  attributes:
    label: Name
- type: checkboxes
  attributes:
    options:
    - label: Your name

也可以向任何冲突的顶级元素提供一个 id。 嵌套复选框元素不支持 id 属性。

name: "Bug report"
body:
- type: textarea
  id: name_1
  attributes:
    label: Name
- type: checkboxes
  attributes:
    options:
    - label: Name

id 属性在问题正文中不可见。 如果要区分生成的问题中的字段,则应使用不同的 label 属性。

Body[i]:缺少所需的键类型

每个正文块必须包含键 type

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的零索引索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:缺少所需的键类型”错误的示例

body:
- attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."

可以通过添加具有有效输入类型的键 type 作为值来修复此错误。 有关可用的 body 输入类型及其语法,请参阅“GitHub 表单架构的语法”。

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."

Body[i]:x 不是有效的输入类型

其中一个正文块包含的类型值不是允许的类型之一。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:x 不是有效的输入类型”错误的示例

body:
- type: x
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."

可以通过将 x 更改为有效类型之一来修复此错误。

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."

Body[i]:缺少必需的属性键 value

尚未提供所需的 value 属性之一。 当块没有 attributes 键或 attributes 键下没有 value 键时,会发生此错误。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:缺少所需的属性键 value”错误的示例

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."
- type: markdown

可以通过在 body 的第二个列表元素的 attributes 下添加 value 作为键来修复此示例中的错误。

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."
- type: markdown
  attributes:
    value: "This is working now!"

Body[i]:标签必须是字符串

在其 attributes 块中,值具有错误的数据类型。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:标签必须是字符串”错误的示例

下面的 label 被分析为布尔值,但它应该是字符串。

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."
- type: textarea
  attributes:
    label: Bug Description
- type: textarea
  attributes:
    label: true

可以通过为 label 提供字符串值来修复此错误。 如果要使用可能会分析为布尔值、整数或小数的 label 值,则应在该值两侧加引号。 例如,应为 "true""1.3",而不是 true1.3

- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."
- type: textarea
  attributes:
    label: Bug Description
- type: textarea
  attributes:
    label: Environment Details

当属性应为字符串时,不允许使用空字符串或仅包含空格的字符串。 例如,不允许使用 """ "

如果属性是必需的,该值必须是非空字符串。 如果字段不是必需的,则应删除键值对。

body:
- type: input
  attributes:
    label: "Name"

Body[i]:id 只能包含数字、字母、-、_

id 属性只能包含字母数字字符、-_。 模板可能在 id 中包含不允许使用的字符,例如空格。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:id 只能包含数字、字母、-、_”错误的示例

name: "Bug report"
body:
- type: input
  id: first name
  attributes:
    label: First name

可以通过确保从 id 值中删除空格和其他不允许的字符来修复该错误。

name: "Bug report"
body:
- type: input
  id: first-name
  attributes:
    label: First name

Body[i]:x 不是允许的键

在与 typeattributes 相同的缩进级别提供了意外的键 x

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:x 不是允许的键”错误的示例

body:
- type: markdown
  x: woof
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."

可以通过删除额外的键以及仅使用 typeattributesid 来修复此错误。

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug! If you need real-time help, join us on Discord."

Body[i]:label 包含禁止词

为了尽量减少在 GitHub 问题中公开发布私人信息和凭据的风险,在输入或 textarea 元素的 label 中不允许使用一些攻击者常用的词。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:label 包含禁止字”错误的示例

body:
- type: markdown
  attributes:
    value: Hello world!
- type: input
  attributes:
    label: Password

可以通过从任何 label 字段中删除“密码”之类的词汇来修复该错误。

body:
- type: markdown
  attributes:
    value: Hello world!
- type: input
  attributes:
    label: Username

Body[i]:x 不是允许的属性

attributes 块中提供了无效的键。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:x 不是允许的属性”错误的示例

body:
- type: markdown
  attributes:
    x: "a random key!"
    value: "Thanks for taking the time to fill out this bug!"

可以通过删除额外的键以及仅使用允许的属性来修复此错误。

body:
- type: markdown
  attributes:
    value: "Thanks for taking the time to fill out this bug!"

Body[i]:options 必须是唯一的

对于复选框和下拉列表输入类型,options 数组中定义的选项必须是唯一的。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:options 必须是唯一的”错误的示例

body:
- type: dropdown
  attributes:
    label: Favorite dessert
    options:
      - ice cream
      - ice cream
      - pie

可以通过确保 options 数组中不存在重复选项来修复此错误。

body:
- type: dropdown
  attributes:
    label: Favorite dessert
    options:
      - ice cream
      - pie

Body[i]:options 不得包含保留字 none

“None”是 options 集中的保留字,因为它用于在不需要 dropdown 时表示不进行选择。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:options 不得包含保留字 none”错误的示例

body:
- type: dropdown
  attributes:
    label: What types of pie do you like?
    options:
      - Steak & Ale
      - Chicken & Leek
      - None
  validations:
    required: true

可以通过删除“None”选项来修复该错误。 如果希望参与者能够表明他们不喜欢这些类型的馅饼,则还可以删除 required 验证。

body:
- type: dropdown
  attributes:
    label: What types of pie do you like?
    options:
      - Steak & Ale
      - Chicken & Leek

在此示例中,“None”将自动填充为可选选项。

Body[i]:options 不得包含布尔值。 请将“yes”和“true”等值两侧加引号

有许多英文单词会被 YAML 分析程序处理成布尔值,除非它们两侧加上引号。 对于下拉列表 options,所有项必须为字符串而非布尔值。

带有 body 的错误将以 body[i] 为前缀,其中 i 表示包含错误的主体块的索引。 例如,可以通过 body[0] 得知错误是由 body 列表中的第一个块引起的。

“body[i]:options 不得包含布尔值。 请将“yes”和“true”等值两侧加引号”错误的示例

body:
- type: dropdown
  attributes:
    label: Do you like pie?
    options:
      - Yes
      - No
      - Maybe

可以通过在每个有问题的选项两侧加引号,以防止它们被处理为布尔值来修复错误。

body:
- type: dropdown
  attributes:
    label: Do you like pie?
    options:
      - "Yes"
      - "No"
      - Maybe

主体不能为空

模板主体 key:value 对不能为空。 有关需要哪些顶级键的详细信息,请参阅“议题表单的语法”。

可以通过添加 body: 部分来修复此错误。

“正文不能为空”错误的示例

name: Support Request
description: Something went wrong and you need help?
---
body:
- type: textarea
  attributes:
    label: "What's wrong?"

在此示例中,可以通过删除标头与 body 部分之间的 ---(文档分隔符)来修复错误。

name: Support Request
description: Something went wrong and you need help?

body:
- type: textarea
  attributes:
    label: "What's wrong?"

延伸阅读