CLion代码补全“能用”需确保clangd索引完成、后缀补全启用、ML排序开启且无AI插件冲突；状态栏显示Clangd: 100%、Settings中启用Postfix Completion和基于机器学习的排序，并禁用Fitten Code等干扰插件。
CLion 的代码补全默认是开启的，但「能用」和「好用」之间差的是几处关键配置——尤其是 C/C++ 项目里 clangd 索引是否就绪、ML 排序是否生效、以及后缀补全（比如 vec.sort() → std::sort(vec.begin(), vec.end())）有没有被意外关闭。
检查 clangd 是否正常运行并完成索引
CLion 的 C/C++ 补全严重依赖后台 clangd 进程。如果状态栏右下角显示 Clangd: indexing 或 Clangd: paused，补全会延迟甚至完全不触发。
- 确保项目根目录有有效的
CMakeLists.txt（CLion 默认靠它驱动 clangd） - 右键点击项目名 → Reload project，强制刷新 clangd 索引
- 若长期卡在
indexing，可临时关闭Settings → Languages & Frameworks → C/C++ → Clangd → Enable clangd，改用内置解析器（牺牲部分语义补全，但响应更稳） - 索引完成后，状态栏应显示类似
Clangd: 100%，此时补全才真正可用
启用后缀补全（Postfix Completion）并验证快捷键
这是 C++ 开发中提升效率最明显的功能之一：输入 vec.for + Tab 自动展开为 range-based for 循环；vec.null → if (vec.empty()) { ... }。但它默认不随基础补全一起激活。
- 进入
Settings → Editor → General → Postfix Completion - 勾选
Enable postfix completion，并确认语言列表中C++已启用 - 常用后缀示例：
vec.iter→ 迭代器循环、vec.var→auto& x : vec、vec.notnull→ 非空判断 - 注意：后缀补全触发键是
Tab，不是Enter；按Enter会插入原始文本而非展开
调整 ML 补全排序与相关性标记
机器学习排序不会增加新建议，但能把你最可能选的项顶到第一位——尤其在 std 命名空间或自定义模板类场景下效果明显。不启用等于浪费 CLion 的核心优势。
- 打开
Settings → Editor → General → Code Completion → Popup - 勾选
Sort suggestions based on machine learning，并在下方语言列表中单独启用C++ - 同时启用
Mark position changes in popup和Mark most relevant item，这样你能一眼看出哪些建议被模型“加权”了 - 首次启用后需积累约 20–30 次补全选择行为，ML 模型才会开始稳定生效；期间可手动多选几次
std::vector、std::string等高频类型加速训练
避免插件冲突导致补全失效
Fitten Code 或 CodeGeeX 这类 AI 补全插件，一旦登录失败或模型未正确切换，会静默劫持基础补全入口，导致 Ctrl+Space 没反应、函数参数不提示等「假性失灵」。
- 先禁用所有 AI 插件（
Settings → Plugins中取消勾选），测试原生补全是否恢复 - 若恢复，再逐个启用：Fitten Code 必须登录且
Model Provider设为Default (Cloud)；CodeGeeX 必须切换模型为CodeGeeX-2-CPP或CodeGeeX-4-CPP - 特别注意：Fitten Code 的
Use local model选项当前版本仍不可用，勾选即导致补全完全空白，且无任何错误提示
真正卡住补全的，往往不是设置没开，而是 clangd 没索引完、后缀补全没绑定语言、或者某个 AI 插件在后台悄悄接管了 Ctrl+Space 却没加载成功——优先查这三处，比反复重装插件快得多。
