我遇到过类似的版本升级后索引异常的情况，结合你的描述（其他同结构文件正常、CMake构建无问题、括号匹配），大概率是CDT索引器的配置或文件识别问题，以下是具体的排查和解决步骤：

一、检查文件类型是否被正确识别 #

CDT对C和C头文件的解析逻辑完全不同，如果你的.h文件被误识别为纯C头文件，遇到extern "C"这种C专属语法就会触发错误：

• 右键问题头文件 → Properties → C/C++ General → File Types
• 确认当前文件关联的是「C++ Header File」，如果是「C Header File」，点击「Add」选择正确类型并设为默认
• 应用设置后，执行 Project → C/C++ Index → Rebuild 刷新索引

二、重置并重建CDT索引缓存 #

升级CDT后，旧版本的索引缓存可能和新版本不兼容，导致单个文件出现解析异常：

1. 关闭Eclipse，找到项目工作区下的.metadata/.plugins/org.eclipse.cdt.core目录，删除整个文件夹（这是CDT的核心索引缓存目录）
2. 重启Eclipse，右键项目 → C/C++ Index → Rebuild
3. 如果不想删除目录，也可以先尝试轻量操作：Project → C/C++ Index → Reset Index，再重建索引，无效再执行步骤1

三、同步预处理器宏定义（确保__cplusplus被正确识别） #

虽然CMake构建正常，但CDT索引器依赖自身的预处理器配置，如果__cplusplus宏未被正确定义，extern "C"块会被当作C代码解析：

• 右键项目 → Properties → C/C++ General → Paths and Symbols → Symbols选项卡
• 检查是否存在__cplusplus宏，如果没有，点击「Add」：
  • 名称填__cplusplus，值根据项目C版本填写（比如201103L对应C11，201703L对应C++17）
• 如果项目是CMake管理的，确保CDT正确同步了CMake配置：右键项目 → C/C++ Project Settings → 点击「Convert to a CMake Project」（若未转换），或重新运行CMake生成器刷新配置

四、排查文件本身的边缘问题 #

个别情况下，文件的编码、特殊字符或注释格式会干扰CDT的解析：

• 检查文件编码：右键文件 → Properties → Resource → Text file encoding，确保和其他正常文件一致（推荐UTF-8）
• 尝试创建一个新的空白.h文件，将原文件内容逐段复制过去（跳过开头可能的特殊隐藏字符），替换原文件后重建索引
• 如果以上都无效，可能是CDT Oxygen的专属bug，可以考虑升级到更高版本的CDT（比如2020-06及以后版本），这类解析边缘case的bug在后续版本中大多被修复

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