Q100475：如何排查 .nuke 目录的问题

概括

本文介绍了如何排查 .nuke 目录的问题，并找出哪些自定义设置可能导致Nuke出现问题。

更多信息

Nuke可以通过添加插件、小工具或其他自定义功能进行高度定制。然而，由于许多自定义功能都是独立编写的，因此当它们组合使用时，可能会导致Nuke运行异常，甚至崩溃。

如果Nuke出现异常行为或崩溃，那么首先要检查的问题是否是由自定义设置引起的。

最好的方法是以安全模式启动Nuke ，因为这样会禁用所有插件、小工具和其他自定义设置，但环境变量除外。有关如何以安全模式启动Nuke信息，请参阅以下文章：

Q100038：以安全模式启动Nuke / NukeX / Nuke Studio / Hiero

如果在安全模式下测试后问题不再出现，则问题很可能是由于对Nuke Nuke自定义设置产生了不利影响。此类自定义设置可以添加到多个位置，具体位置请参见下方的Nuke文档：

加载 Gizmos、NDK 插件以及 Python 和 Tcl 脚本

为了进一步确定是哪项自定义设置或哪些自定义设置组合导致了问题，我们建议以详细模式启动Nuke ，并按照本文中的步骤操作：

Q100112：以详细模式启动Nuke并隔离可能导致问题的自定义设置

注意：详细的Nuke日志可能会显示与某些自定义文件相关的错误，这有助于缩小调查范围。

.nuke 目录

最常添加自定义项（例如脚本或小工具）的地方是位于用户主目录下的 .nuke 目录，这些自定义项可能会对Nuke产生不利影响。用户 .nuke 目录的默认位置如下所示：

Windows： C:\Users\<username>\.nuke

Linux： /home/<username>/.nuke用户名>/.nuke

macOS： /Users/<username>/.nuke

注意：请注意，在某些操作系统中，.nuke 目录可能被隐藏。如果遇到这种情况，请查阅操作系统文档，了解如何显示隐藏目录并访问 .nuke 目录。

在进行故障排除时，如果暂时删除 .nuke 文件夹可以解决问题，那么下一步就是找出 .nuke 目录中导致问题的自定义设置。

故障排除步骤

要检查 .nuke 目录中的某个自定义文件是否导致问题，最简单的方法是将 .nuke 目录重命名为类似“old.nuke”的名称。下次启动Nuke时，它会创建一个新的 .nuke 目录。如果问题不再出现，则表明是原始 .nuke 目录中的某些内容导致了问题。

此时，用户的主目录应包含以下文件夹：

old.nuke - 最初的自定义

.nuke - 上次Nuke启动时创建的默认目录

在 old.nuke 目录下，为了准确找出问题所在，一个有效的方法是使用分块排查法。这种方法的思路是不断地将待测文件分成两半，分别测试每一部分，看看问题是否仍然存在，直到找到罪魁祸首。

注意：在执行此方法之前，请确保您的计算机上除了用户 .nuke 目录中的插件、小工具或自定义设置之外，没有其他插件、小工具或自定义设置。

分半故障排除方法：

1. 进入 old.nuke 文件夹，并将一半的自定义文件复制到Nuke创建的新 .nuke 目录中。
2. 重新启动Nuke并检查问题是否仍然存在。
3. 如果问题仍然存在，请前往 .nuke 目录并删除一半的文件。重新启动Nuke ，查看问题是否依然存在。重复此步骤，直到 .nuke 文件夹中只剩下一个文件为止。此时，您就找到了导致问题的自定义设置。
4. 如果将旧 .nuke 目录的一半复制到新的 .nuke 目录后问题不再出现，则删除 .nuke 目录的内容，然后从旧 .nuke 目录内部复制你尚未测试的另一半，并重复步骤 3。
5. 如果复制并测试旧版 .nuke 目录的任一部分内容后问题不再出现，则表明某些自定义设置影响了系统配置。在这种情况下，请将整个旧版 .nuke 目录的内容重新复制到新的 .nuke 目录中，然后一次删除一个自定义文件，启动Nuke并测试问题是否仍然存在，直到找到触发问题的最小文件组合。

一旦找到能够重现问题的单个自定义文件或最小文件集，就可以对这些文件进行进一步的故障排除。使用相同的分半排查方法，可以逐行删除代码，直到在文件中找到相关部分。

根据自定义类型的不同，像 TCL 或 Python 脚本这样的文件可以在文本编辑器中打开并进行进一步测试，而像编译后的 NDK 插件这样的其他文件可能无法编辑，因此需要联系插件的创建者。