常见问题：获取帮助¶

我如何制作X动画？为什么会收到Y错误？有人能帮助我吗？¶

在向社区提问之前，请确保您遇到的问题尚未在我们的常见问题部分中得到充分讨论，以便您可以自行解决问题。您也可以尝试使用您喜欢的搜索引擎，如果幸运的话，可能会找到一篇博客文章、StackOverflow 上的问题，或 r/manim subreddit 上的帖子。

如果不是这种情况，请花点时间妥善准备您的问题：您越能清楚地解释您究竟在挣扎什么，人们就能越高效地帮助您。无论您下一步选择哪个平台，StackOverflow 都有一个关于如何提出好问题的优秀指南。

一旦您清楚地知道自己想问什么，请选择以下沟通渠道之一：

社区在我们的 Discord 服务器上最为活跃。点击链接加入，然后在侧边栏中选择一个#manim-help频道，并在那里发布您的问题。如果您熟悉使用 Discord，请尝试使用我们服务器的搜索功能来搜索您的问题；也许之前有人讨论过它！
我们也会关注 StackOverflow 上标有manim标签的问题。
许多人也活跃在我们的r/manim subreddit，如果您是狂热的 Reddit 用户，请随时在那里发布——但请注意，Discord 或 StackOverflow 可能是更好的选择。
最后，如果您不喜欢所有其他选项，也可以在GitHub 上发起新的讨论。

在所有这些渠道中，请务必遵守 Manim 的行为准则——简而言之，请对彼此友善：友善、耐心、体贴和尊重。

尝试看看您的问题是否可以改进：您是否包含了所有相关信息（如果是错误：完整的堆栈跟踪、您正在渲染的代码以及您用来运行 Manim 的命令）？如果您使用了一个非常长的示例，是否有可能构建一个具有相同（错误）行为的更精简版本？

如果您在 Discord 的帮助频道中发布了问题，但问题被淹没了，您可以 @Manim Helper 角色来引起志愿者的注意，他们愿意帮忙查看。请不要在第一次提问时立即 @该角色，这被认为是不礼貌的。

如果您觉得在最初选择的渠道中没有成功，也可以尝试将问题发布到不同的渠道——但请不要在所有沟通渠道中（尤其是 Discord：请不要同时使用多个帮助频道）发送垃圾邮件。

归根结底，对于大多数开源项目来说都是如此：我们的社区成员是志愿者。如果您的问题没有得到快速回答，可能是因为没有人知道答案，或者您的问题不够清晰，也可能是所有能帮助您解决问题的人都在忙其他事情。

听起来您发现了一个 bug。报告 bug 是对 Manim 开发贡献的最佳方式之一！

请查看我们 GitHub 仓库中的已知问题和功能请求列表：此处。如果您发现的问题尚未列出（请使用搜索功能；也请检查是否有相应的已关闭问题，您的特定问题可能已经解决，并将在下一个版本中修复），请考虑以下步骤提交新问题。

注意

如果您不确定是否应该为某些奇怪行为提交新问题，请随时向社区开发者提问，最好是在我们 Discord 中的 #manim-dev 频道之一。

请确保您正在运行 Manim 的最新发布版本，否则您的问题可能已经在最新版本中得到修复。请查看更新日志以获取 Manim 各版本之间的完整变更列表。
在创建新问题时，请为您的报告选择正确的类别。我们有专门的 issue 模板用于bug 报告、功能请求和安装问题。如果您的报告属于这些类别之一，请仔细阅读 issue 模板！说明在文本字段的部分中给出。如果您想在没有具体实现细节的情况下建议新功能，请参阅本答案中给出的说明。
对于 Bug 报告：准备一个可用于说明问题的最小示例。包含数百行代码的示例非常低效且难以调试。您的问题需要对其他人是可重现的，因此请务必准备一个合适的示例。
这在 bug 报告模板中也有提到，但它非常重要：如果您报告某个代码引发错误，请务必包含完整的终端输出，从您用于运行库的命令到包含错误消息的最后一行。请仔细阅读：如果消息提到有另一个相关的日志文件，请也包含该文件！