夜雨聆风学习资料网

ARTICLE · 1375142

Nuke 插件完整安装教程|Gizmo / Python / NDK / OFX 通用指南

Nuke 插件完整安装教程|Gizmo / Python / NDK / OFX 通用指南
   最近来了很多新朋友,看到又有好多人问插件怎么安装的。
今天就发一篇安装指南把,还有之前发布的一些插件,后台自动回复有限制,有一些可能已经不在了,准备抽一些时间做一些优化,看看有没有什么好的办法让大家拿到想要的插件,这个可能要等一段时间了。
Nuke 插件是合成师提升效率的核心工具,包含.gizmo、Python 脚本、NDK 编译插件(.dll/.so/.dylib)、OFX 插件、BlinkScript 内核等多种格式。很多新手装完插件 Tab 栏搜不到、菜单不显示,大多是路径、init.py、menu.py三者没理清。本文覆盖个人单机安装、团队共享路径、排错方案,适配 Windows / Mac / Linux 全平台。

前置提醒:不要直接把插件丢进 Nuke 软件安装目录,升级 Nuke、权限问题都会导致插件失效,这是官方不推荐的做法。

一、先找到你的 .nuke 目录(个人用户首选)

.nuke是 Nuke 默认自动扫描的用户配置目录,Nuke 启动时会自动加载里面的内容,适合个人本机使用。

  • Windows:C:\Users\你的用户名\.nuke 快捷键(win+R)
    资源管理器地址栏直接粘贴 %USERPROFILE%\.nuke 回车快速打开
  • Mac:/Users/你的用户名/.nuke(默认隐藏,访达按 Shift+Command+. 显示隐藏文件)
  • Linux:/home/你的用户名/.nuke

如果文件夹不存在,直接新建名为 .nuke 的文件夹即可,第一次启动 Nuke 也会自动生成。

目录结构推荐(规范管理插件)

在.nuke里面分类建子文件夹,方便后续维护:

.nuke

├─ gizmos/        # 存放所有gizmo工具

├─ python/        # Python脚本、工具包

├─ ndk_plugins/   # NDK编译插件(dll/so)

├─ icons/         # 菜单图标png/svg

├─ init.py        # 全局路径、环境配置(渲染和交互都会加载)

└─ menu.py        # 菜单栏、工具栏、快捷键(仅交互界面加载,渲染不执行)

重点区分两个启动文件(绝大多数踩坑点)

  1. init.py:Nuke 不管是界面打开、还是命令行渲染,都会优先读取。适合写pluginAddPath添加插件路径、设置默认格式、全局参数。不要在这里写 UI 菜单代码,渲染时会报错。
  2. menu.py:只有打开 Nuke 图形界面才加载,适合添加顶部菜单、节点工具栏、快捷键、自定义面板。

二、四种插件类型安装步骤

1. Gizmo(最常用,.gizmo)

两种方式:方式 A(极简):直接把.gizmo丢进.nuke,重启 Nuke,Tab 输入名字即可调用。方式 B(推荐,分类存放):

  1. 把 gizmo 放到 .nuke/gizmos
  2. 打开init.py,添加路径注册代码:
    import nukenuke.pluginAddPath('./gizmos')
3.想要放到顶部菜单 / 工具栏,在menu.py添加:
toolbar = nuke.toolbar("Nodes")toolbar.addCommand("我的工具/调色Gizmo", "nuke.createNode('MyColorGizmo')", icon="icons/color.png")
4.重启 Nuke,Tab 搜索或者直接在工具栏点击使用。
2. Python 插件(.py 工具、面板、脚本)
  1. 脚本包 / 单 py 文件放入 .nuke/python
  2. init.py
    加入路径:
    nuke.pluginAddPath('./python')
    3.如果是面板工具,在menu.pyimport 并添加菜单:
    import MyPanelnuke.menu("Nuke").addCommand("工具集/打开面板", MyPanel.show_panel)
NDK 编译插件(dll /so/dylib,C++ 编译的原生插件)

这类插件是编译好的二进制文件,严格区分 Nuke 版本、Python 版本、系统架构,版本不匹配直接加载失败。

  1. 插件文件夹放入 .nuke/ndk_plugins
  2. init.py
    添加路径:
nuke.pluginAddPath('./ndk_plugins')
重启 Nuke,Tab 调用。
注意:Nuke13 之后是 Python3,Nuke16 开始切换 PySide6,旧 PySide2 插件无法直接使用,下载前核对插件说明。
4. OFX 插件(OFX 特效插件,如 NeatVideo、RE:Vision)

OFX 不走普通 NUKE_PATH,使用独立环境变量 OFX_PLUGIN_PATHFoundry

  • Windows:系统环境变量新增 OFX_PLUGIN_PATH,值填写 OFX 插件文件夹
  • Mac/Linux:同样配置环境变量,多个路径用冒号:分隔(Windows 用分号;) 配置完成后重启 Nuke,在 Other 分类或者 Tab 搜索 OFX 节点。
5. BlinkScript 内核(.rpp/.blib,BlinkKernel)
BlinkScript 不需要放到插件目录,在 BlinkScript 节点面板内加载内核文件;也可以把 blib 库放在自定义路径,在节点 File 路径里引用,适合自研 GPU 加速工具

三、团队共享方案:NUKE_PATH 环境变量(工作室多机)

多人协作、多版本 Nuke 分开加载插件,不污染本地.nuke,用NUKE_PATH环境变量实现。

  • Windows:系统环境变量新建NUKE_PATH,多个路径用英文分号隔开
Z:\studio_nuke_plugins;Z:\gizmos_shared
Mac/Linux:在启动脚本 /.bashrc/.zshrc写入,冒号分隔
export NUKE_PATH="/mnt/studio/plugins:/mnt/studio/gizmos"

原理:Nuke 启动时,会扫描 NUKE_PATH 里的所有目录,自动读取目录内的init.py、menu.py和插件文件。进阶:可以写 Nuke 启动批处理 / Shell 脚本,不同版本 Nuke 加载不同插件包,解决新旧插件兼容冲突。

四、验证插件是否加载成功(调试命令)

打开 Nuke 内置 Script Editor(脚本编辑器),输入下面命令回车:

# 查看当前所有插件扫描路径print(nuke.pluginPath())
  • 你的插件路径出现在列表里 → 路径注册成功
  • 路径存在但 Tab 搜不到:检查插件包名、节点类名拼写、版本兼容
  • 报错弹窗:优先看 Console 控制台报错信息

五、高频问题排查清单

  1. 重启 Nuke 才生效:所有init.py、menu.py、新增路径,必须重启 Nuke,热加载有很多限制。
  2. 插件放对目录,Tab 搜不到:   - 检查插件是否适配当前 Nuke 版本(Nuke14 插件大概率不能直接给 Nuke17 用)   - 压缩包解压有没有嵌套一层同名文件夹(常见:插件文件夹里面还有一层同名文件夹)
  3. 打开 Nuke 直接闪退:   - init.py写了 UI 代码、或者插件版本不匹配、损坏   - 测试:临时改名.nuke,Nuke 以干净环境启动,逐个插件定位问题
  4. 菜单有了,点击没反应:   - menu.py里面节点名称写错、图标路径错误、依赖的第三方 Python 库缺失
  5. 渲染农场渲染不加载插件:   - 菜单 UI 代码写在menu.py没问题;路径注册必须写在 init.py,渲染进程不读取 menu.py

    六、最佳实践总结

    1. 个人合成:优先.nuke目录,分类管理 gizmo、python、ndk,用 init 统一加路径,干净好迁移。
    2. 工作室流水线:统一用 NUKE_PATH 共享盘,区分版本插件包,避免版本混乱。
    3. 下载插件第一时间核对:支持 Nuke 版本、系统、Python2/Python3、PySide2/PySide6。
    4. 备份:直接备份整个.nuke文件夹,换电脑、重装系统一键恢复所有自定义工具。

       这是常规的NUKE插件安装方法,现在说一个非常规,对于一些嫌麻烦,或者看不懂插件安装步骤的人来说的一个安装方法,就是使用AI帮助你来安装。

  1. 使用豆包安装
下载桌面版豆包:https://www.doubao.com/pc/desktop-fission/pro-trial/invited?inviteCode=mRnzjKRoUt
然后在对话选择工作任务本地电脑:
把你要安装的插件目录告诉他,然后他就会自动帮你安装到NUKE里面。这个对看不懂安装教程,或者不熟悉NUKE命令的新人来说是最快的办法了。前几天发布的CorridorKey v2.0抠像的一键安装包,后台很多人反馈安装不上,是因为我写的一键安装脚本可能跟你电脑的Python版本不一样,导致的,每个人的Python都不一样,所有这个没办法解决,就可以通过豆包帮你修改我给的一键安装命令,来进行安装。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料