autocomplete-plus 插件未生效需依次检查：是否已启用、是否安装对应语言provider、文件后缀与语言模式是否匹配、补全触发键是否为enter而非tab、项目级变量补全需ctags+autocomplete-ctags配合。
autocomplete-plus 插件没生效？先确认它是否真被启用
Atom 默认不自带完整自动补全能力，autocomplete-plus 是必须手动安装并启用的核心插件。很多人以为装完就自动工作，结果敲 cons 不弹 console.log，其实是插件压根没激活。
- 打开 Atom →
Settings→Packages，搜索autocomplete-plus，确认状态是 Enabled（不是灰色的 “Install” 或 “Disabled”） - 如果已安装但未启用，点右侧的
Enable按钮；如果没装，点Install，装完会自动启用 - 装完别忘了重启 Atom —— 尤其在 Windows 上，后台进程常驻，不重启新插件可能不加载
输入几个字母没反应？检查触发条件和语言支持
autocomplete-plus 默认只对部分语言开启，且有最小输入长度限制（默认 2 字符），JS/HTML 文件里敲 c 不出建议，是正常行为；但敲 co 还没反应，大概率是语言识别失败或缺少对应 provider。
- 确认当前文件后缀正确：比如写 JS 必须保存为
.js，Atom 才会加载autocomplete-javascript提供商 - 检查右下角状态栏的语言模式（如显示 “Plain Text”），点击它 → 选 “JavaScript” 或对应语言
- 基础补全靠
autocomplete-plus，但具体建议内容由“provider”提供，例如：autocomplete-html负责标签、atom-ternjs负责 JS 变量和函数签名 - 如果只装了
autocomplete-plus，没装任何 provider，那它只会返回空列表 —— 就像有插座没接电器
为什么按 Tab 不插入建议？改用 Enter 或检查 keymap
Atom 默认用 Enter 确认补全项，不是 Tab；很多人习惯 VS Code 或 Sublime 的 Tab 行为，一试就卡住。
- 补全弹窗出现后，用方向键选择 → 按
Enter插入；按Esc关闭 - 若坚持用
Tab，可在Keymap设置里自定义：打开Settings → Keymap，加一行：'atom-text-editor[data-grammar~="source"]:not([mini])':\n 'tab': 'autocomplete-plus:confirm'
- 注意：全局把
Tab绑给补全后，在缩进场景（比如写 JSON 或空行）可能误触发，建议仅在明确需要时调整
项目级变量不提示？需要 ctags + autocomplete-ctags 配合
默认的 autocomplete-plus 只能识别语法层面的关键词（如 function、if）和内置 API，你定义的 const apiHost = "https://api.example.com" 不会出现在补全列表里 —— 这不是 bug，是设计如此。
- 要补全项目内函数、变量、类名，得配
atom-ctags+autocomplete-ctags - 先全局装 ctags：
brew install ctags（macOS）、sudo apt install exuberant-ctags（Ubuntu）、Windows 用户推荐universal-ctags并加进 PATH - 在项目根目录运行：
ctags -R --languages=javascript生成tags文件 - Atom 会自动读取该文件，但需确保
autocomplete-ctags已启用，且设置里勾选了 “Use project tags file”
跨文件跳转和补全依赖这层索引，漏掉 ctags 步骤，再怎么调 autocomplete-plus 设置也没用。
