Wheelchart编译报错WCvarB未定义控制序列的原因及解决方法

报错原因 #

Undefined control sequence. \pgfkeyscurrentkey ->\WCvarB的核心触发逻辑：

• wheelchart宏包的WCvarB是内部用于数据解析的临时变量，尽管手册说明该变量会自动初始化，但在自定义日历模板场景下（比如修改了原模板的数据结构、自定义了pgfkeys参数），宏包的自动初始化逻辑可能未覆盖你的使用场景，导致变量未定义就被调用。
• 另一种可能是数据格式错误（比如列表分隔符混用、嵌套内容未正确用大括号分组），触发宏包解析时意外引用了未初始化的WCvarB；或是使用的旧版本宏包存在自动初始化的bug。

修正方案 #

1. 强制手动初始化变量 #

在导言区或调用wheelchart命令前，添加一行代码显式定义WCvarB，直接规避变量未定义的报错：

\newcommand{\WCvarB}{}

2. 排查数据格式与pgfkeys配置 #

• 检查数据源：确认轮状日历的日期、分组等数据的分隔符是否正确，内部嵌套逗号的内容必须用大括号{}包裹，避免宏包解析时误拆分数据触发WCvarB的引用。
• 检查自定义参数：排查你修改的wheelchart键值配置（比如slice style、data label等自定义代码），确认是否残留了\WCvarB的引用（哪怕是模板复制时的冗余代码），如果有则删除或替换。

3. 更新wheelchart宏包 #

若使用的是旧版本宏包，可能存在自动初始化逻辑的bug，更新到最新版本后，宏包的默认初始化逻辑可能覆盖你的使用场景，解决报错问题。

4. 清理冗余pgfkeys配置 #

把你不确定的冗余pgfkeys键值对暂时注释掉，逐一恢复排查，定位是否是某个冗余配置触发了宏包对WCvarB的调用，找到后删除或调整该配置。

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