Excel中用MacroOptions方法为UDF分配帮助文件的异常问题

我在Excel中用VBA的Application.MacroOptions方法给自定义函数（UDF）分配CHM帮助文件时遇到了异常：

1. 先编写了一个简单的自定义函数：

Function myUDF()
myUDF = "it is test"
End Function

打开函数向导点击「此函数的帮助」时，Excel提示「无可用帮助」，这是正常的初始状态。

2. 运行以下代码为该函数分配帮助文件：

Sub SetHelpFile()
        Application.MacroOptions _
            Macro:="'" & ThisWorkbook.Name & "'!" & "myUDF", _
            HelpFile:=ThisWorkbook.Path & "\CHM-example.chm", _
            HelpContextID:=10010
End Sub

所用的CHM文件包含指定的主题ID（示例为10010），是标准测试样本文件。但出现了奇怪的现象：

• 首次运行代码后，确认帮助文件已分配，但点击帮助无法跳转到指定页面；
• 再次运行该代码后，点击帮助就能正常显示对应页面。

请问这是Excel的Bug吗？

编辑：有测试文件可复现该问题。

问题解答 #

这个现象大概率是Excel配置缓存未即时刷新导致的小问题，算不上严格意义上的Bug。

原因分析

• 首次调用Application.MacroOptions时，Excel虽然写入了帮助文件的配置信息，但函数向导的缓存数据没有同步更新，导致帮助跳转逻辑无法识别新配置；
• 再次运行代码时，相当于强制触发了配置的二次写入，此时Excel完成缓存更新，帮助跳转就能正常工作。

解决办法

• 运行一次SetHelpFile后，关闭并重新打开Excel文件，再打开函数向导测试，大概率不需要二次运行代码就能正常跳转；
• 也可以在SetHelpFile代码末尾添加强制刷新逻辑，比如调用Application.CommandBars("Function Wizard").Reset，不过这个方法可能影响其他自定义设置，谨慎使用。

注意事项

• 确保CHM文件路径为绝对路径，且文件确实存在于指定位置，避免路径解析错误；
• 主题ID必须和CHM文件内的ID完全匹配，数字ID一般无大小写问题，但需保证完全一致。

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