---
headerDepth: 0
category: [公告]
icon: iconfont icon-debug
order: 2
comment: false
redirectFrom: /statements/bug-report.html
---

# 提交 BUG 报告

在你使用 Snap Hutao 时如果发现了可复现或不可自行修复的问题，可以通过提交问题反馈来告知开发者。

![suggestion](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01jXBMbe1g6du15k9kx_!!1797064093.jpg_.webp)

在发起新的 Issue 之前，请先执行以下清单：

- [ ] 当前使用的是最新版本客户端
- [ ] 阅读[常见问题](../advanced/FAQ.md)文档和[已知问题](../advanced/known-issue.md)文档
- [ ] 搜索项目 Issue，检查是否已有相同或类似的问题
- 若执行上述步骤后没有得到问题解决方案，你可以在 GitHub 上发起一个新的 Issue

如果你不清楚怎样是一个好的 Issue 可以阅读 Snap Hutao 过去的一些[优质问题](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E4%BC%98%E8%B4%A8%E9%97%AE%E9%A2%98+is%3Aclosed)

- 通过 GitHub 提交问题
  - [github.com/DGP-Studio/Snap.Hutao/issues/new/choose](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose)
- 在 Issue 中，你应包含以下内容：
  - [ ] 你的设备 ID
  - [ ] 你的操作系统版本
  - [ ] 详细描述你的问题，开发人员应能根据你的描述复现问题
    - [ ] 问题是如何触发的
    - [ ] 程序或操作系统有怎样的错误提示
    - [ ] 你执行了怎样的操作排查问题，有什么结果
  - [ ] 如果你的问题涉及到程序崩溃，你需要在 Windows 事件查看器中寻找和 Snap Hutao 相关的 `.NET 错误` 并将其中的内容附加在 Issue 中

## 远程调试

在一些问题无法被定位时（即开发者无法在自己的设备中复现问题时），开发者可能会向社区成员询问发起远程调试，在有问题的设备上debug寻找问题解决方案。在这种情况下，若你同意，一个指定的管理员将通过 QQ 加你为好友并拉你进入远程协助群以方便交流。

**参与远程调试的计算机需要至少 15GB 的可用硬盘空间。**

在开始调试之前，你需要执行[贡献代码](../development/contribute.md)中`设置 Snap.Hutao项目`一段中的第`1~3`步骤，并下载安装 [ToDesk](https://www.todesk.com/download.html) 远程工具。

## 请求增加或更新文档

如果你认为 Snap Hutao 的文档缺少重要内容或有错误的信息，可以从 Snap.Hutao.Docs 项目中发起 Issue

- 通过 GitHub 提交问题：[DGP-Studio/Snap.Hutao.Docs](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/new/choose)
