InteractiveHtmlBom在macOS上的单选按钮显示问题解析

在KiCad插件InteractiveHtmlBom 2.9.0版本中，macOS用户报告了一个界面显示问题。具体表现为"Highlight first pin"选项的三个单选按钮（None/All/Selected）在macOS 14.3.1（ARM架构）系统上出现重叠显示的现象。

问题现象分析

该问题主要出现在使用KiCad 8.0.2版本内置的wxPython组件时。当插件创建包含三个选项的单选按钮组时，这些选项没有正确排列，而是相互重叠在一起，导致用户无法清晰地看到和选择所有选项。

技术背景

这个问题实际上源于KiCad项目使用的定制版wxWidgets框架。wxWidgets是一个跨平台的C++ GUI库，wxPython是其Python绑定版本。在标准的上游wxWidgets/wxPython版本中，单选按钮组(RadioBox)能够正常显示，但在KiCad的定制版本中出现了渲染异常。

问题根源

通过最小化测试代码可以确认，这是一个底层GUI框架的渲染问题。测试代码创建了一个简单的wxPython窗口，包含一个三选项的单选按钮组。在标准wxPython环境下显示正常，但在KiCad的定制版本中就会出现选项重叠。

这种差异表明KiCad项目在定制wxWidgets时可能修改了某些与macOS平台相关的渲染逻辑，或者包含了特定版本的bug。考虑到该问题在标准版本中不存在，可以确定这是KiCad定制版本引入的问题。

解决方案

由于这是底层框架的问题，InteractiveHtmlBom插件本身无法直接修复。用户可以选择以下解决方案：

1. 等待KiCad官方修复其wxWidgets分支中的这个问题
2. 临时调整界面布局，避免使用单选按钮组控件
3. 考虑使用其他控件类型（如下拉菜单）作为替代方案

对于开发者而言，在跨平台GUI开发时需要注意：

1. 不同平台对控件的渲染可能有差异
2. 使用第三方定制框架时需注意其可能引入的特殊行为
3. 重要的界面元素应有备用布局方案

总结

这个案例展示了跨平台GUI开发中可能遇到的典型问题。虽然InteractiveHtmlBom插件本身代码正确，但由于依赖的GUI框架在特定平台上的实现差异，导致了显示异常。这也提醒开发者在使用深度定制的第三方库时需要特别注意其在不同平台上的兼容性表现。