autocomplete-clang插件在Atom中默认无法直接工作，核心原因是它不自带Clang二进制，且对compile_commands.json路径、Clang版本、C++标准等高度敏感；配错任意一项，autocomplete-plus就只显示“no suggestions”或无响应。
autocomplete-clang 插件在 Atom 中默认无法直接工作，核心原因是它不自带 Clang 二进制，且对 compile_commands.json 路径、Clang 版本、C++ 标准等非常敏感——配错任意一项，autocomplete-plus 就只会显示“no suggestions”或根本无响应。
确认系统已安装可用的 Clang
autocomplete-clang 不会帮你装 Clang，它只调用你本地的 clang 或 clang++。macOS 自带的 Apple Clang（来自 Xcode Command Line Tools）通常版本偏旧、缺少某些 C++20 符号，容易导致补全失败；Linux 上用包管理器装的 clang 可能没装 clang-tools 子包（含 clangd 和头文件支持）。
- 运行
clang++ --version，确保输出里包含clang version 12.0.0或更高（推荐 ≥14） - 检查
clang++ -resource-dir是否能正常返回路径；如果报错或为空，说明 Clang 安装不完整 - Windows 用户必须使用 LLVM 官方预编译包（不是 Visual Studio 自带的 MSVC 工具链），并把
bin/加入PATH
生成并放置 compile_commands.json
autocomplete-clang 默认只认项目根目录下的 compile_commands.json，且该文件必须由构建系统生成——手写几乎必错。CMake 是最可靠来源，但要注意启用导出：
- CMake 配置时加参数：
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON - 生成后检查 JSON 是否为数组，每项含
directory、command、file字段；若command是空字符串或含ccache未正确展开，补全会静默失败 - 不要用
compile_flags.txt替代：autocomplete-clang 已弃用该方式，设了也无效
Atom 设置中关键配置项
插件设置页面（Atom → Preferences → Packages → autocomplete-clang）里，以下三项必须显式填对，留空或填错路径会导致整个补全引擎不启动：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
-
Libclang Library Path：指向libclang.so（Linux）、libclang.dylib（macOS）或libclang.dll（Windows）。常见位置：/usr/lib/llvm-14/lib/libclang.so、/opt/homebrew/opt/llvm/lib/libclang.dylib、C:\Program Files\LLVM\bin\libclang.dll -
Compile Commands：填绝对路径，如/home/user/myproject/compile_commands.json；相对路径（如./compile_commands.json）会被忽略 -
C++ Standard：选c++17或c++20，必须和你compile_commands.json里实际使用的-std=一致，否则模板、概念等提示全丢
常见无提示问题排查顺序
补全不出现？别急着重装插件，按这个顺序查：
- 打开 Atom 开发者工具（
Ctrl+Shift+I），切到 Console，输入atom.packages.getActivePackage('autocomplete-clang').mainModule.provider，看是否为undefined——是则插件根本没加载成功，多半是Libclang Library Path错了 - 在项目根目录运行
clang++ -fsyntax-only -Xclang -code-completion-at=-:1:1 test.cpp（test.cpp内容为#include <vector>），观察是否输出补全候选；不输出说明 Clang 本身不支持当前上下文 - 关掉所有其他 C++ 相关插件（比如
ide-cpp、atom-clang），它们会和 autocomplete-clang 抢text.c++语法作用域
最常被忽略的是：Clang 资源目录缺失、compile_commands.json 里 directory 字段路径不真实存在、以及 Atom 启动时没在项目根目录打开（它不会自动向上查找 compile_commands.json）。这些点卡住，调再久设置也没用。
