GIMP 2.10 Python插件注册失败：gimp_wire_read()错误求助

数据老陈

2026-6-16

GIMP 2.10 Python插件注册失败（gimp_wire_read()错误）排查与解决

问题概述

为GIMP 2.10.38编写极简Python插件，仅实现函数注册与main逻辑，但插件无法在Image菜单和插件浏览器中显示。运行gimp-2.10 --verbose时控制台输出：

Querying plug-in: 'C:\Users\alpac\AppData\Roaming\GIMP\2.10\plug-ins\knit_pc_plugin.py'
gimp-2.10.exe: LibGimpBase-WARNING: gimp-2.10.exe: gimp_wire_read(): error

直接用系统Python运行插件会提示No module named 'gimpfu'，移除插件函数的timg、tdrawable参数后问题依旧。

错误原因分析

注册前触发UI交互：你在register()和main()之前调用了msg('Running knitpc')，GIMP加载插件时会先查询元数据，此时执行pdb.gimp_message这类弹窗操作会中断注册流程，引发gimp_wire_read()错误。
菜单路径转义错误：注册时写的<Image>/Image/Knit...是转义后的字符，GIMP无法识别正确的菜单位置，应该用原生的<Image>标记。
系统Python运行报错是正常现象：gimpfu是GIMP自带Python环境的专属模块，不能用系统Python直接执行插件。

解决步骤

移除注册前的UI交互代码：删除msg('Running knitpc')和msg('Registered function')、msg('Ran main')这类在注册流程外的弹窗调用。
修正菜单路径：将<Image>改为<Image>，让GIMP正确识别菜单位置。
保留必要参数：针对图像的插件必须保留timg和tdrawable参数，GIMP会自动传入当前活动图像与图层。

修正后的插件代码

#!/usr/bin/python

from gimpfu import *

def msg(txt):
    pdb.gimp_message(txt)

def knitpc(timg, tdrawable):
    msg('Hello ')

register(
    'knit_pc_plugin',
    'Test plugin',
    'Test plugin',
    'Me',
    'Me',
    '2024',
    '<Image>/Image/Knit...',  # 修正菜单路径
    '*',
    [],
    [],
    knitpc
)

main()