Python使用win32com获取Excel IRibbonUI跨回调引用方法

尝试重建IRibbonUI实例的思路从COM机制上就不成立：{000C03A7-0000-0000-C000-000000000046}是IRibbonUI的接口ID（IID），不是可实例化COM类的CLSID，微软从未公开IRibbonUI实现类的注册信息，不管怎么给派生类传这个ID调用pythoncom.new，都会触发“类未注册”错误，完全没必要尝试新建实例。
网上提到的IDTExtensibility2相关方案是针对传统COM/VSTO加载项的，用PyXLL开发XLL加载项时不需要实现这个接口，PyXLL已经封装了和Excel交互的底层COM逻辑。

官方推荐的onLoad回调保存引用的思路完全可行，直接存win32com生成的IRibbonUI包装对象容易出问题，核心原因是静态包装类实例绑定了创建时的COM套间上下文，PyXLL触发控件回调时可能切换线程套间，直接调用旧包装对象会触发RPC错误。正确的做法是缓存IRibbonUI对象的底层PyIDispatch指针，使用时重新包装为可用的win32com代理对象，实现步骤如下：

1. 定义模块级缓存容器（可以是全局变量，也可以用单例类封装，避免全局变量污染）

import win32com.client
import pythoncom

# IRibbonUI接口ID
_IRIBBON_IID = pythoncom.MakeIID("{000C03A7-0000-0000-C000-000000000046}")
_ribbon_dispatch = None

2. 在onLoad回调中只保存ribbon对象的底层_oleobj_（即PyIDispatch实例），不要直接存win32com包装后的对象

def ribbon_on_load(ribbon):
    global _ribbon_dispatch
    _ribbon_dispatch = ribbon._oleobj_

3. 封装统一的获取Ribbon实例的方法，每次调用时从缓存的IDispatch指针重新QueryInterface生成可用的代理对象

def get_ribbon_ui():
    if not _ribbon_dispatch:
        raise RuntimeError("功能区未完成加载，无法获取IRibbonUI引用")
    # 基于缓存的IDispatch指针包装为win32com可调用的IRibbonUI代理
    return win32com.client.Dispatch(
        _ribbon_dispatch.QueryInterface(_IRIBBON_IID, pythoncom.IID_IDispatch),
        clsctx=pythoncom.CLSCTX_INPROC_SERVER
    )

4. 在任意控件的onClick等回调中，直接调用该方法获取ribbon实例，即可正常调用Invalidate/InvalidateControl等方法

def test_button_on_click(ctrl):
    ribbon = get_ribbon_ui()
    # 刷新指定控件状态，触发对应回调重跑
    ribbon.InvalidateControl("ribbon_control_1")

如果不想用模块级全局变量，可以用类属性封装缓存逻辑，效果完全一致：

class RibbonCache:
    _disp = None

    @classmethod
    def init(cls, ribbon_com_obj):
        cls._disp = ribbon_com_obj._oleobj_

    @classmethod
    def get(cls):
        if not cls._disp:
            raise RuntimeError("Ribbon未初始化")
        return win32com.client.Dispatch(
            cls._disp.QueryInterface(_IRIBBON_IID, pythoncom.IID_IDispatch)
        )

# onLoad回调中初始化
def ribbon_on_load(ribbon):
    RibbonCache.init(ribbon)

# 其他回调中使用
def btn_click(ctrl):
    RibbonCache.get().InvalidateControl("target_ctrl_id")

• 不要尝试序列化/持久化这个IDispatch指针，Excel进程重启后指针会失效，仅在当前Excel进程生命周期内缓存有效
• 不需要手动处理COM对象的引用计数，win32com和PyXLL会自动管理生命周期
• 如果遇到调用时的权限错误，确认PyXLL加载项和Excel运行在相同的权限级别，不要用管理员权限单独跑IDE调试，否则会因为COM权限隔离无法访问Excel的Ribbon对象

内容的提问来源于stack exchange，提问作者CaffeinatedMike