Q100710： Mari 问题故障排除指南

Tomas Miguel

更新: 2026年05月12日 22:45

创建: 2025年01月22日 15:28

概括

有时您可能会遇到Mari反复出现的问题，或者某些功能无法按预期运行。如果您想自行解决此类问题，本文将帮助您成为优秀的Mari故障排除专家。本文提供了一系列通用故障排除技巧，可以帮助您深入了解问题并找到解决方案。

在调查问题时，要清楚自己需要查找哪些信息。

请记住，在进行故障排除时，您可以追求许多积极的结果，例如：

找到一种变通方法，让你可以通过不同的步骤完成任务。
清楚地知道应该避免哪些设置，以免问题再次发生。
消除故障触发后的症状。
恢复丢失的工作。
与他人分享你的发现。
更好地了解Mari 。

要取得所有这些结果，都需要尽可能全面地了解问题的以下几个方面：

重现步骤- 触发条件并导致问题出现的具体操作顺序。这些步骤应尽可能简化和精简。
条件- 指问题发生所需的具体情况，这些情况需按特定顺序在重现步骤中激活。例如，节点属性设置为特定值、首选项使用错误、第三方插件、文件损坏或 OCIO 配置不完整。
触发器- 当所有条件都满足时，触发器会执行具有意外行为的操作。
症状- 除了意外行为之外，某些触发因素还可能导致您的作品发生变化，即使在条件消除后，这些变化也可能仍然存在，例如纹理损坏。

以下建议的部分测试将为您提供此类信息，您可以利用这些信息进行故障排除并找到解决方案。同时，其他一些测试可能直接解决您的问题，从中您可以推断出问题的原因。

确认您的计算机支持Mari

为了确认您的计算机是否完全支持Mari请将您的配置与我们的要求进行比较。这对于性能、画布渲染和文件 I/O 问题尤为重要。请参阅：
Mari的系统要求
 Q100701： Mari支持的操作系统兼容性列表

在知识库和缺陷跟踪系统中搜索您的问题

您遇到的问题可能是已知问题， Foundry的支持团队已经进行了全面调查。在这种情况下，解决您的问题所需的信息可能已经在支持门户中提供，您可以使用以下页面上的搜索栏进行查找：

Mari的 Bug 追踪系统- 如果您的问题属于已知 Bug，则会有一个公开 Bug 报告，其中描述了问题、重现问题的具体步骤、受影响的Mari版本以及任何已知的解决方法或方案。您可以根据这些信息找到适合您需求的解决方案。您可以在这里了解更多关于 Bug 追踪系统的信息：
Q100068：什么是缺陷跟踪器？如何使用它？
Mari的知识库- 除了提交错误报告外， Foundry的支持团队还会撰写文章（例如本文），帮助您解决各种工作流程和故障排除问题。您可以在这里找到特定问题的修复方法和变通方案、推荐的最佳实践（其中可能包含问题发生的原因）、如何恢复丢失的工作、如何提高性能等等。

请查看发行说明中的“已知问题”部分。

Mari的发行说明包含“已知问题”部分，其中列出了我们希望在后续版本中解决的所有已知严重错误，以及相关的临时解决方案。您可以在此处找到适用于您Mari版本的发行说明：
Mari的发行说明

更新Mari以获取最新的错误修复和功能增强。

如果您使用的是较旧版本的Mari ，您的问题可能已经在后续版本中通过错误修复或功能增强得到了解决。您可以点击此处查看最新版本的Mari并下载：
下载Mari

卸载并更新或降级您的GPU驱动程序

Mari出现问题可能是由于 GPU 驱动程序故障引起的，尤其是在性能、纹理和视口方面。因此，您可以尝试升级（或降级）NVIDIA 或 AMD 驱动程序，重新打开Mari ，然后检查问题是否已解决。

为了彻底升级显卡驱动，您可以先完全卸载当前驱动程序，以确保不残留任何有问题的组件。为此，您可以使用诸如显示驱动卸载程序 (DDU) 之类的工具。

您可以在以下页面找到 DDU 和您机器的驱动程序：
显示驱动程序卸载程序 - 下载
 Nvidia驱动程序
 AMD驱动程序

在不同的安全模式级别下重现此问题

我们的第一个实际测试是尝试在不同的安全模式级别下重现该问题，理想情况下是从头开始重现。如果您发现该问题在某个级别下无法重现，这可能表明问题出在哪里。例如：

如果使用--safe=4后问题不再出现，则该问题可能与Mari某个设置不是默认值有关，因此您可能需要开始在首选项或工具属性中查找问题的根源。
如果即使在新的示例项目中使用--safe=8也出现此问题，则可以确认此问题是Mari固有的，很可能是一个错误（除非您的Mari安装已损坏）。

在安全模式下进行测试时，请记住，它不一定能解决在正常Mari会话中操作导致的问题。它是否能修复现有问题本身就是一个有价值的信息。例如，假设您触发了一个未知来源的问题，导致 Paint 节点中的纹理数据消失：

如果纹理在安全模式下恢复正常，则表示这些症状仅在触发器激活时才会出现。问题可能在于 Canvas 无法渲染您现有的纹理。
如果安全模式无法恢复纹理，则说明即使移除触发因素后，该症状仍然存在，因此纹理可能已经损坏。

要了解什么是安全模式、其不同级别以及如何使用这些级别启动Mari ，请参阅：
Q100022：使用更安全的模式以全新安装方式启动Mari

注意：如果安全模式解决了您的问题，那么解决此问题的方法并非总是以安全模式启动Mari ，因为总是像全新安装一样启动Mari会存在各种限制。相反，您必须利用安全模式提供的信息，在常规Mari下解决问题。

检查问题是否仅限于某个项目

无论您目前专注于解决问题还是理解问题，了解您是否能够在其他项目中重现该问题都应该能为您提供一些有用的见解：

例如，如果问题仅出现在您的原始项目中，那么可能是烘焙点节点过多，或者您的 UV 贴图有问题。另一方面，如果您能在另一个项目中轻松重现该问题，那么或许特定的节点设置与此无关，或者您的几何体本身没有问题。

要检查问题是否与项目相关，最好的方法是在Mari的示例项目中尝试重现该问题。因为在另一台计算机上正确设置的完整项目包上进行测试可以确保问题的解决。在某些情况下，也可以创建一个内容尽可能少的全新项目进行测试。在这种情况下，您可以使用简单的几何体创建自己的测试项目。

要创建示例项目的新版本，请打开Mari并选择“帮助”>“创建示例项目” 。

将安全模式与示例项目结合使用

在以上两节中，我们分别介绍了安全模式和示例项目，以及如何将它们用作故障排除工具。请记住，对于大多数问题，您应该首先尝试在安全模式下使用示例项目重现问题。这是因为同时执行这两个测试可以确定问题是否是Mari本身的问题，因为您可以同时排除第三方插件和不正确的项目设置等变量。完成此测试后，您可以根据需要分别尝试使用每个故障排除工具。

删除用户配置

如果使用`--safer=4`参数后问题不再出现，或者您认为问题与您的用户自定义配置（例如布局、首选项、工具属性或快捷键）有关，那么您可以尝试删除这些配置，将Mari重置为出厂默认设置。虽然这可能会丢失您对Mari所有个性化设置，但通常可以立即解决许多问题，例如工具行为异常、性能不佳，甚至启动时崩溃。

要将Mari重置为默认设置：

关闭Mari后，移动或重命名您的TheFoundry文件夹。这样做会阻止Mari查找和加载您的配置文件，但您可以保留一份备份。
启动Mari 。由于Mari找不到TheFoundry文件夹，它将使用默认设置从头开始重新创建。
看看你的问题是否已解决。
如果问题已解决，但您想恢复一些配置，现在可以在Mari会话之间尝试将一些文件从原始TheFoundry文件夹移回新的TheFoundry文件夹。
执行步骤 4 时，您会发现恢复特定文件会重现问题。这应该能指出问题的根源，您可以根据需要进行进一步调查。罪魁祸首通常是Mari 7.1v1文件，因此您甚至可以在步骤 1 中尝试仅删除此文件并重新启动Mari ，然后再尝试删除整个TheFoundry父文件夹。

有关Mari的配置文件夹及其位置的更多信息，请参见此处：
Q100723： Mari的用户配置文件及其位置

注意：您很可能需要恢复“书架”文件夹以恢复您的书架内容，因为这很有价值，而且通常不是任何问题的根源。

读取Mari日志文件或详细输出

Mari Log.txt 文件是您在使用Mari时生成的报告。它记录了应用程序正在处理的所有信息，包括错误和崩溃报告。因此，它是故障排除的宝贵资源，因为它可能有助于您找到问题的原因。

重现您的问题，打开Mari Log.txt 文件，并仔细阅读最后几行，看看是否有任何有用的信息。以下文章提供了有关Mari Log.txt 文件及其查找位置的更多信息：
Q100020： Mari的Mari Log.txt 文件及其位置

在某些情况下，实时查看Mari Log.txt 输出可能很有帮助，这样可以了解您执行的某些操作在后台是如何处理的。为此，请以“详细输出”模式启动Mari ：
Q100589：如何启动带有详细输出的Mari以帮助进行故障排除

识别并减少步骤和条件

如果您知道一组能够稳定重现问题的步骤，那么您应该能够进一步找出触发问题的确切条件。为此，请反复重现问题，但每次重现时执行以下操作之一：

移除一些步骤，然后检查问题是否仍然存在。
- 例如，可能不需要查看特定节点即可触发崩溃，因此可以删除该步骤。
不要设置步骤，而是尝试移除条件。
- 例如，如果您在查看频道时遇到阴影错误，请移除上游节点的某些部分，直到阴影错误解决。这将有助于您确定导致问题的具体节点。
尝试用不同的方法重现该问题。
- 例如，您可以直接从绘制节点导出纹理，而无需使用导出管理器。如果从绘制节点导出时没有出现问题，那么问题可能不在于导出操作本身，而在于导出管理器。

这些是常见的故障排除技巧，可以帮助您准确找出问题所在。一旦了解了具体情况，就更容易避免这些问题。这甚至可以帮助您找到问题的症结所在（例如，通过更改工具的属性），从而解决问题。

通过这种故障排除方法，您还可以改进对发现的、需要报告给Foundry支持团队的问题的描述。由于更清晰的描述有助于我们重现您的问题，因此我们也更有可能及时回复您，提供问题解决方法建议以及您发现的所有错误的完整报告。

重新安装Mari

您遇到的问题可能是由于计算机上Mari的安装不正确导致的。这可能会导致启动问题、功能缺失、数据丢失以及其他问题。但是，简单地重新安装Mari并不等同于“恢复出厂设置”，因此可能无法解决这些问题。这是因为Mari使用的某些内容不会被应用程序的卸载程序从您的计算机中彻底清除。

以下文章介绍了如何彻底卸载Mari 。卸载完成后，请从第二个链接下载Mari的安装程序并重新安装：
Q100138：卸载Mari及其所有相关内容
 下载Mari

与社区讨论

请记住，您并非孤身一人，其他Mari用户很可能也遇到过您目前遇到的问题。除了联系客服之外，您还可以与其他艺术家讨论您的问题。

我们拥有许多热衷于分享知识、共同充分利用Mari的社区。这些社区是提问、解决问题以及讨论任何与Mari和纹理相关的问题的绝佳场所。

我们有一个官方的Mari社区论坛，您可以在这里找到它：
Foundry社区 - Mari艺术家

还有一个活跃的Mari Discord群组。点击此处加入：
Discord邀请链接

延伸阅读

根据您遇到的问题，以下文章或许对您有所帮助：

概括

更多信息