Files
BallanceBlenderHelper/docs/docs/zh-cn/report-bugs.md
2025-01-17 22:22:51 +08:00

2.4 KiB
Raw Blame History

报告问题

什么会出错

BBP不是完美的由于BBP的Virtools文件导入导出模块是由C++编写的因此BBP比其他插件更容易出错且出错的后果可能会更严重包括但不限于内存泄漏误删除用户文件少前2事件一样)等)。

在Blender中如果插件执行出错你将会观察到

  • 期待的效果没有达成
  • 鼠标处弹出一大堆你看不懂的堆栈输出文本
  • 使用Window - Toggle System Console打开控制台后可以观察到Python的异常输出。

哪部分出错了

对于BBP插件而言如果你在Python异常输出中观察到类似于BMap operation failed的字样,或者在%LOCALAPPDATA%/CrashDumps文件夹(%LOCALAPPDATA%是一个Windows环境变量如果你不清楚它是什么你可以简单地将该地址直接粘贴到Windows文件资源管理器中Windows文件资源管理器会自动为你导航到正确位置下观察到了blender.exe.<xxx>.log文件(其中<xxx>是一串数字则说明BBP插件的由C++编写的BMap部分出错了你需要立即保存你当前的Blender文档并退出Blender。 因为此时插件已处于非正常状态,你不应继续任何操作。

如果并没有上述情况那么这就只是普通的Python代码执行错误不需要过度担心但错误仍然是致命的建议做完所有必要的操作后退出Blender并报告错误。

向何处报告

如果你有GitHub账户你可以在BBP的存储库的Issue页面中创建并汇报问题。

如果做不到,且你有合适的渠道可以联系到插件作者,则直接汇报给插件作者也是可以的。

报告的内容

首先你需要详细描述你是如何引发这个错误的,这个错误有什么结果。如果可以上传导致错误的文档,请尽量上传(如果不方便公开发布,可以通过邮件等私有渠道发送给作者)。

你还需要提供Blender控制台中输出的Python堆栈报告使用Window - Toggle System Console打开控制台。如果你的错误是BMap部分的错误你还需要提供BMap模块输出的错误日志文件blender.exe.<xxx>.log和内存转储文件blender.exe.<xxx>.dmp<xxx>同理为一串数字),这些文件同样可在%LOCALAPPDATA%/CrashDumps文件夹中找到。