Atom本身不提供开箱即用的智能代码补全，必须依赖语言服务插件或语法感知型补全插件，且前提为正确识别文件语言：仅当文件后缀与grammar scope匹配时，autocomplete-plus才能获取上下文并触发补全。

Atom 本身不提供开箱即用的智能代码补全（如函数签名、参数提示、跳转定义），它依赖语言服务插件（如 atom-ide-ui + 对应语言包）或语法感知型补全插件（如 autocomplete-plus 配合 language-python）。但前提是：Atom 必须先正确识别文件语言——否则补全引擎压根不会启动。

为什么 .sh / .conf / .env 文件没补全？

Atom 不靠文件内容“猜”语言，只看两件事：文件后缀名 + 当前 grammar scope。如果后缀不在语言插件注册的 fileTypes 列表里，或 grammar scope 没被正确绑定，autocomplete-plus 就收不到语法上下文，补全项为空或只有基础单词匹配。

• 常见失效场景：.env 被当成 Plain text（实际该用 source.env）；.conf 被映射到 source.java-properties（错！该用 source.apache-conf 或 source.nginx-conf）
• 验证方法：打开目标文件 → 按 Ctrl+Shift+P → 输入 Editor: Log Cursor Scope → 看第一行输出是否为预期 scope（如 source.python）
• 临时修复：右下角点语言名 → 手动选对（如 Bash、INI、Apache Conf）→ 补全通常立刻生效

如何永久绑定 .xxx 后缀到正确 language

必须改 config.cson，其他地方（插件设置、styles.less、UI 点选）都不影响新建/重载行为。

• 路径：macOS/Linux 是 ~/.atom/config.cson，Windows 是 %USERPROFILE%\.atom\config.cson
• 写法示例（加在 core: 下）：

  core:
    fileTypes:
      '.sh': 'source.shell'
      '.env': 'source.env'
      '.conf': 'source.apache-conf'
      '.ini': 'source.ini'

• scope 名必须准确：装了 language-ini 才有 source.ini；装了 language-apache 才有 source.apache-conf；查 scope 名最稳方式仍是 Editor: Log Cursor Scope
• 改完保存，不用重启 Atom，但已有标签页不刷新，新开文件才生效

补全插件没反应？先确认这三件事

即使语言识别正确，补全也可能静默失败。

• autocomplete-plus 插件必须启用（默认已装，但可能被禁用）
• 对应语言的语法包必须安装且启用（例如 Python 补全依赖 language-python，不是只装 autocomplete-python）
• 某些补全插件（如 autocomplete-paths）只在特定 scope 生效，比如 source.python 下才提示 import 路径，source.shell 下就不管用
• 若用 atom-ide-ui，需额外装配套 ide-python/ide-typescript，且它们对 Node.js 版本敏感（2026 年主流要求 Node ≥ 18.17）

语言识别是补全的门槛，不是装饰。很多用户调了一堆 autocomplete 设置却无效，问题往往出在 config.cson 里那一行 fileTypes 映射没写对，或者 scope 名拼错了字母——这种错误没有报错，只有沉默。