> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/report-bug.md).

# 报告错误

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

如果您在 Decentraland SDK 和 Creator Hub 中的场景编辑器里遇到任何错误或问题，请在我们的 GitHub 仓库中报告 [这里](https://github.com/decentraland/sdk/issues/new/choose).

## 在报告错误之前

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

* 请确保您使用的是最新版本的 SDK，以防该问题已经在较新的版本中修复。
* 请查阅您要使用的功能文档，以确认它的行为应当符合您的预期，而不是只是误解了其设计。
* 排除问题可能是由您的场景构建方式导致的。请参见 [在预览中调试](/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/debug-in-preview.md) 和 [在生产环境中调试](/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/debug-in-prod.md) 获取提示。
* 避免重复。请查看 [已知错误列表](https://github.com/orgs/decentraland/projects/20/views/13) 以避免重复提交。如果您有更多信息要补充到已有问题中，请在该问题下添加评论，而不是创建一个新问题。

## 报告错误

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

1. 访问以下链接： [新建问题页面](https://github.com/decentraland/sdk/issues/new/choose)
2. 点击 **开始使用** 旁边的 **错误报告**. ![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e570baea44fa2ebc22551edee413d515cc2e965d%2Freport-bug.png?alt=media\&token=ffa85157-31ad-401f-9165-f3f2e254d818)
3. 填写模板中的所有字段。模板为每个部分都提供了说明。您能提供的细节越多，我们的开发者就越快能识别并解决问题。
4. 点击 **提交新问题**.

![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fa14673bdfa946c4f579a941396e980e23ce3b77%2Fsubmit-issue.png?alt=media\&token=51b8197d-55b5-4512-99fc-db28ee27d001)

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

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

您也可以在 [DAO Discord](https://discord.gg/bxHtcMxUs4).
{% endhint %}

**错误报告的额外提示：**

* 为每个错误创建单独的问题。如果您遇到多个问题，请确保为每个问题都创建一个新问题。
* 避免长篇解释。仅在必要时包含相关的命令行或控制台输出，或场景代码。
* 如果可能，请附上图片或视频。您可以轻松地将它们拖放到问题文本区域中，GitHub 会负责上传和链接。

## 使用 Decentraland Playground

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

您可以在问题文本中粘贴代码片段，但提供代码片段的最佳方式是使用 [Decentraland Playground](https://playground.decentraland.org/)。请按照以下步骤操作：

1. 在左侧编写您的代码片段，并在右侧面板查看您的场景。
2. 点击 **分享** 按钮，并将链接粘贴到您的问题报告中。

![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-27251378c6274dfa5888c63c4aa0e87d83bafd75%2Fplayground.png?alt=media\&token=b58f4ce6-c1aa-4bce-8f58-e4903592f2e2)

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

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

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

## 获取日志

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

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

## 编辑文档

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

## 功能请求和建议

如果您有添加新功能或特性的建议，而不是报告问题，请加入 [Decentraland Discord 服务器](https://dcl.gg/discord) 并在 [Creator Hub 频道](https://discord.com/channels/417796904760639509/1288888172318560326) 中发帖，而不是创建 GitHub Issue。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/report-bug.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.