跨头文件使用Extends_Instance宏触发编译错误排查

问题情况 #

我有input_service.h和instances.h两个文件，instances.h中定义的Extends_Instance宏在本文件内使用完全正常，但在input_service.h中使用该宏时触发编译错误。

相关代码 #

input_service.h #

#pragma once

#include <placeholder/instances/instances.h>
#include <placeholder/ff.h>

typedef enum e_keyState {
    KS_NOT_PRESSED   = 0b00000000,
    KS_JUST_PRESSED  = 0b00000010,
    KS_JUST_RELEASED = 0b00000100, 
    KS_HELD          = 0b00000010
} e_keyState;

// % (KeyDown, KeyPressed, KeyReleased, KeyUp) -> `@property InputService->m_getKeyState`

typedef struct InputService {
    Extends_Instance;  // !!!!!! 错误位置 !!!!!! 
    // Extends_Instance -> <error-type>
    // 


    // & `(e_keyState & KS_DOWN) == 0` -> 按键被持续按住
    // => `(e_keyState & KS_RELEASED) == 0` -> 按键刚被释放
    // => ... 参考 `@enum e_keyState`
    public method(m_getKeyState, e_keyState)(struct InputService *self, char key_code);
    internal method(m_frameBegun, void)(struct InputService *self);
    
    internal readOnly ALLEGRO_KEYBOARD_STATE last_state;
    internal readOnly ALLEGRO_KEYBOARD_STATE now_state;
} InputService;
constructor function InputService* service_create_input_service(void);

instances.h代码片段 #

#define Extends_Instance char             *name;                                         \
                                                char             *class_name;                                   \
                                                size_t            id;                                           \
                                                struct Instance  *parent;                                       \
                                                struct Instance  *children[MAX_CHILDREN];                       \
                                                uint32_t          children_count;                               \
                                                method           (m_draw, void)(struct Instance *self);         \
                                                method           (m_debugDraw, void)(struct Instance *self);    \
                                                hashtable_t       children_fi;                                                      \
                                                bool              enable_debugging


// & (? `@class Instance`) !
typedef struct Instance { Extends_Instance; } Instance;  !!!!!! 这里为什么没报错？ !!!!!! 

编译错误信息 #

../placeholder/instances/services/input_service.h:16:9: error: expected specifier-qualifier-list before ‘Extends_Instance’
   16 |         Extends_Instance;
      |         ^~~~~~~~~~~~~~~~

原因分析与解决方法 #

这个错误的核心是**Extends_Instance宏展开后的内容包含编译器无法识别的标识符**，导致结构体定义解析失败，具体排查方向：

• 补全宏依赖的定义：Extends_Instance中用到了MAX_CHILDREN、hashtable_t、method等标识符，instances.h内部使用时可能已经通过其他头文件引入了这些定义，但input_service.h仅包含instances.h，如果instances.h没有主动包含这些依赖的头文件，就会触发编译失败。需要在instances.h中补充包含对应依赖（比如定义hashtable_t的头文件、定义MAX_CHILDREN的配置头文件）。
• 验证自定义宏的加载：public、internal、method是自定义宏，用于声明结构体成员的访问权限或方法，需要确保这些宏的定义在input_service.h中被正确加载。可以检查instances.h是否包含了定义这些宏的头文件，或者在input_service.h中手动引入对应头文件。
• 确认宏换行转义的正确性：虽然代码中用\处理了宏的换行，但要检查最后一行是否有多余空格或语法错误，确保宏展开后是合法的结构体成员列表。

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