CLion语法高亮自发消失 等待或重启后恢复的修复方法

问题根因 #

运行日志明确报出clangd crashed错误，故障核心是CLion内置的clangd语言服务进程意外崩溃：

• 代码提示功能不受影响，是因为该能力依赖提前构建的项目全量静态索引，不依赖实时运行的clangd进程
• 故障10分钟左右自行恢复、重启CLion临时恢复，本质都是CLion的进程守护机制自动拉起了崩溃的clangd服务，没有解决触发崩溃的根本诱因

故障佐证 #

• CLion正常状态（高亮生效）
• CLion故障状态（高亮消失）

核心报错片段 #

clangd crashed. PLEASE CONSIDER adding the following preprocessed files to the crash report.
Code and file paths will be obfuscated. By default, they will NOT be attached and they will NOT be sent.
Files that might cause failure:
file:///C:/Users/Orion/CLionProjects/QT/Source%20Files/main.cpp, compilerDiags=WAITING, highlightings=WAITING, DFAInput=WAITING, CLion-clang-tidy=WAITING, Clazy=WAITING, clang-tidy=WAITING

修复方案（按生效概率从高到低排序） #

• 调高clangd内存上限，解决OOM崩溃
  2022.2版本CLion内置clangd默认堆内存上限仅2GB，Qt项目依赖头文件数量多，解析时极易触发内存溢出崩溃。操作步骤：打开Settings > Advanced Settings > Clangd，找到Clangd maximum heap size配置项，将数值修改为4096（内存16G及以上的设备可设为8192），保存后重启CLion。
• 裁剪冗余静态检查规则，降低clangd运行负载
  从日志可见当前环境同时开启了全量clang-tidy、Clazy、CLion原生三套静态检查，叠加g++23标准的解析开销，极易触发clangd段错误。操作步骤：打开Settings > Editor > Inspections，先取消Clazy全量检查项的勾选，再将clang-tidy的检查规则从当前全量开启的bugprone-*、clang-analyzer-*裁剪为实际开发需要的最小规则集，禁止开启无使用需求的全量扫描。
• 替换内置clangd为MinGW配套版本，解决兼容性崩溃
  2022.2版本CLion内置的clangd对MinGW 11.2.0 + g++23的组合存在已知兼容缺陷，解析特定模板语法时会触发崩溃。操作步骤：
  • 定位Qt自带MinGW环境下的clangd路径，默认路径为C:\Qt\Tools\mingw1120_64\bin\clangd.exe
  • 打开Settings > Build, Execution, Deployment > Toolchains > Clangd，取消勾选Use clangd bundled with CLion
  • 路径选择前述MinGW目录下的clangd.exe，保存后重启CLion
• 清除损坏的项目缓存
  损坏的历史索引缓存也会反复触发clangd解析异常。操作步骤：点击顶部菜单File > Invalidate Caches...，勾选Clear file system cache and Local History，确认后等待CLion自动重新构建全量索引即可，索引重建过程不要强制终止进程。

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