Q100373：如何向 Nuke Studio 和 Hiero 添加额外的插件路径

概括

本文介绍如何向Nuke Studio和Hiero添加插件路径，以便加载和使用其他插件和 Python 模块。这可以通过HIERO _PLUGIN_PATH环境变量或hiero .core.addPluginPath()函数来实现。

注意：从Nuke 14.1 和 15.0 开始， HIERO _PLUGIN_PATH环境变量已被弃用，取而代之的是NUKE _PATH ，其行为应该相同。

更多信息

当Nuke Studio和Hiero扫描要导入的 Python 模块或插件时，它们会搜索所有
<path>/Python/Startup和<path>/Python/StartupUI目录用于存放任何包含__init__.py文件或其他插件（例如 gizmos）的 Python 模块或包。这意味着您的自定义模块或插件目录结构需要定义Python/Startup或Python/StartupUI目录。

首先扫描所有Python/Startup文件夹，然后扫描所有Python/StartupUI文件夹。找到的任何 Python 启动脚本都会按字母顺序导入，并作为插件加载供Nuke Studio和Hiero使用。

环境变量法

要将额外的 <path> 位置添加到Nuke Studio和Hiero扫描的插件路径列表中，可以使用环境变量HIERO 。多个路径需要用分号;在 Windows 上分隔，或用冒号:在 macOS 和 Linux 上分隔，类似于Nuke的NUKE的工作方式。

例如，如果将HIERO _PLUGIN_PATH设置为/mnt/networkdrive/shared/plugins ，则Nuke Studio和Hiero将按顺序扫描以下目录：

/mnt/networkdrive/shared/plugins/Python/Startup
/mnt/networkdrive/shared/plugins/Python/StartupUI

有关如何设置环境变量的信息，请参阅以下文章： Q100015：如何设置环境变量

有关上述内容的更多信息，请参阅我们的在线Python API 文档中的“环境设置”部分。

Python 方法

您还可以使用以下 Python 命令添加其他<path>位置：

import hiero .core
 hiero .core.addPluginPath("/custom_plugin_path")

由于Nuke Studio和Hiero会在<path>/Python/Startup和<path>/Python/StartupUI位置查找 Python 模块或插件，因此使用上述命令附加的新插件路径需要明确地在文件路径中包含Python/Startup或Python/StartupUI 。

例如，如果您运行以下代码行：

hiero .core.addPluginPath("/mnt/networkdrive/shared/plugins")

Nuke Studio和Hiero将按顺序扫描以下目录：
/mnt/networkdrive/shared/plugins/Python/Startup
/mnt/networkdrive/shared/plugins/Python/StartupUI

这些代码通常包含在用户.nuke文件夹下的Python/Startup目录中的init.py文件中。

有关如何使用Python/Startup和Python/StartupUI目录的更多信息，请参阅： Q100142：如何在NukeStudio启动时执行Hiero Python 代码