报告错误

如何报告错误，以便其被审查并修复

如果您在 Decentraland SDK 和 Creator Hub 中的场景编辑器里遇到任何错误或问题，请在我们的 GitHub 仓库中报告 这里.

在报告错误之前

在提交错误报告之前，请确保以下几点：

• 请确保您使用的是最新版本的 SDK，以防该问题已经在较新的版本中修复。

• 请查阅您要使用的功能文档，以确认它的行为应当符合您的预期，而不是只是误解了其设计。

• 排除问题可能是由您的场景构建方式导致的。请参见 在预览中调试 和 在生产环境中调试 获取提示。

• 避免重复。请查看 已知错误列表 以避免重复提交。如果您有更多信息要补充到已有问题中，请在该问题下添加评论，而不是创建一个新问题。

报告错误

要报告 SDK 的错误，您需要一个 GitHub 账号。请按照以下步骤操作：

1. 访问以下链接： 新建问题页面

2. 点击 开始使用 旁边的 错误报告.

3. 填写模板中的所有字段。模板为每个部分都提供了说明。您能提供的细节越多，我们的开发者就越快能识别并解决问题。

4. 点击 提交新问题.

如果开发者需要进一步说明或更多信息，他们可能会在您的工单上向您提问。您会收到有关错误报告更新的电子邮件通知。

📔 注意：对于任何与 SDK 无关的问题，请联系支持团队。要联系我们，请访问此页面 intercom.decentraland.org 或发送电子邮件至 [email protected]。您也可以在 Discord找到我们。团队可在周一至周日 UTC 时间 12 点到 21 点提供帮助，并会尽力尽快回复。在上述时间段内，您可以在 Discord 上于 60 分钟内收到回复，电子邮件则会在 24 小时内回复。

您也可以在 DAO Discord.

错误报告的额外提示：

• 为每个错误创建单独的问题。如果您遇到多个问题，请确保为每个问题都创建一个新问题。

• 避免长篇解释。仅在必要时包含相关的命令行或控制台输出，或场景代码。

• 如果可能，请附上图片或视频。您可以轻松地将它们拖放到问题文本区域中，GitHub 会负责上传和链接。

使用 Decentraland Playground

提供能演示问题的代码片段非常有帮助。可复现性至关重要。如果一个错误无法复现，就很难诊断和修复。

您可以在问题文本中粘贴代码片段，但提供代码片段的最佳方式是使用 Decentraland Playground。请按照以下步骤操作：

1. 在左侧编写您的代码片段，并在右侧面板查看您的场景。

2. 点击 分享 按钮，并将链接粘贴到您的问题报告中。

使用 playground 可简化问题复现，并确保任何打开链接的人都能看到相同的输出，而不受其操作系统、SDK 版本、Node 版本等影响。它还有助于快速迭代，以识别受影响的条件并定位问题原因。

请尽量让您的示例保持简洁，同时仍能复现问题。更简单的示例有助于消除对问题来源的歧义。

📔 注意：在 Playground 中无法将资源导入您的场景。因此，如果复现该问题需要导入 3D 模型或音频文件，那么在那里将无法展示。

获取日志

在报告错误时，获取 Decentraland 浏览器的日志通常很有用。

要获取日志，只需打开聊天并输入 /logs。这将打开一个新窗口，显示 Decentraland 浏览器的日志。请将 Player.log 文件附加到您的问题报告中。

编辑文档

如果您在文档网站的内容中发现问题，可以提交更改请求。只需滚动到页面底部并点击 编辑此页面 按钮。GitHub 将引导您通过您的更改创建一个拉取请求。基金会团队会审查您的更改，如果认为有用，就会发布它们。

功能请求和建议

如果您有添加新功能或特性的建议，而不是报告问题，请加入 Decentraland Discord 服务器 并在 Creator Hub 频道 中发帖，而不是创建 GitHub Issue。