atom所有功能依赖作用域链，排查问题须先用ctrl+shift+p执行editor: log cursor scope查看当前作用域；补全失效、片段不触发、多光标异常等均源于作用域配置错误或冲突。
Atom 编辑器本身不执行编译或运行，所有“高效编程”效果都依赖插件组合与快捷键的精准触发——装错包、配错作用域、忽略作用域继承规则，是 80% 用户卡在“为什么片段不生效”“为什么补全没反应”的根本原因。
autocomplete-plus 补全失效的三个真实原因
不是插件没装，而是它默认只对 .source.js、.source.python 这类标准作用域生效。如果你用的是自定义后缀（如 .jsx、.ts）或非标准文件名（如 config.yaml），autocomplete-plus 会直接跳过。
- 检查当前文件实际作用域：按
Ctrl+Shift+P输入Editor: Log Cursor Scope，看输出里是否含.source.js或你期望的作用域 - 手动绑定作用域：在
config.cson中添加'*.jsx': 'source.js'映射 - 禁用冲突插件：
language-babel和atom-ide-ui同时启用时，常因语言服务抢占导致补全延迟或消失
多光标编辑中 Alt+F3 选不全匹配项？
Alt+F3（Windows/Linux）或 Cmd+Ctrl+G（macOS）触发的是「当前作用域内全文本匹配」，不是「当前文档全文本匹配」。它严格受语法树节点限制——比如你在函数体内触发，就不会选到函数外同名变量；你在字符串里触发，就只匹配该字符串内的内容。
- 先确保光标不在引号/括号/注释内部，再按
Alt+F3 - 想跨作用域全选？用
Ctrl+F打开查找面板，输入关键词，勾选Case Sensitive和Whole Word，再点Select All - 误操作后光标乱飞？按
Esc立即退出多光标模式，避免后续输入污染多个位置
自定义代码片段（snippets）不触发？重点看这三处
片段写在 .atom/snippets.cson 里，但 Atom 加载时只认结构合法、作用域精确、前缀无歧义的条目。常见失败点不在语法，而在上下文隔离。
- 作用域必须完整且带点前缀：
'.source.js'有效，'source.js'无效；'.text.html.basic'是 HTML 文件的实际作用域，不是'.html' - 前缀不能是保留字：
if、for、return在某些语言包下会被拦截，改用ifx、forr更稳妥 - 片段主体中禁止出现未转义的
$：$1是合法停位点，但$PATH会被当作环境变量展开失败，应写成\$PATH
构建系统（Build System）运行报错 javac: command not found？
这不是 Atom 的问题，是系统 PATH 没把 JDK bin 目录暴露给 GUI 应用。macOS 和 Linux 图形界面启动的 Atom 不继承终端的 ~/.zshrc 或 ~/.bash_profile 环境变量，Windows 则常因用户级 PATH 未刷新而失效。
- macOS：在终端执行
open -a "Atom"启动，而非点击 Dock 图标 - Linux：从终端运行
atom .，或修改桌面启动器 Exec 字段为env "PATH=$PATH:/path/to/jdk/bin" atom %F - Windows：重启 Atom 前，右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，确认
JAVA_HOME和%JAVA_HOME%\bin已加入系统 PATH 并点击“确定”刷新
最易被忽略的点：Atom 的所有功能都建立在“作用域链”之上。一个文件可能同时匹配 .source.js、.source.jsx、.text.html.basic 多个作用域，而插件只响应它声明支持的那个。查问题前，先按 Ctrl+Shift+P 运行 Editor: Log Cursor Scope——这是唯一能让你看清 Atom 此刻“认为”你在哪的命令。
