光标必须位于可折叠语法块的内容区内（如JS的{ }之间、HTML script标签内代码区）才能触发折叠；语言模式需正确识别文件类型，且对应language包已启用并支持折叠规则。
光标必须落在可折叠结构内部才能触发折叠
按 Ctrl+Alt+[（Windows/Linux）或 Cmd+Option+[（macOS）没反应，大概率不是快捷键错了，而是光标位置不对。Atom 的折叠是上下文敏感的：它只对当前光标所在语法块的内容区生效。
- JavaScript 中，光标得在
{和}之间的某一行（哪怕只是缩进后的空行），不能停在function foo() {这行开头或}所在行 - HTML 中，
<script>标签内的 JS 代码能折，但光标不能停在<script>或</script>标签名上 - Python 默认不识别
def或class为可折叠单元，光标即使在缩进块内也无效——需装python-fold插件 - 注释行、空行、函数声明行本身都不是“内容区”，按下快捷键必然无响应
语言模式必须正确，否则折叠直接失效
右下角状态栏显示 Plain Text 是最常见原因。Atom 不识别文件类型，就不会加载对应语法包，foldingStartMarker 配置根本不会被读取。
- 点击右下角语言标识 → 手动选择正确 mode，如
Source JavaScript、Vue Component、Python - 确保已启用对应 language 包：
language-javascript（基础 JS）、language-babel（JSX/TS）、language-vue（.vue 文件） - YAML/TOML 等配置语言默认支持弱，旧版
language-yaml可能不带折叠规则，建议升级或换用language-yaml-ace - 自定义后缀（如
.spec.js、.env）若未注册getFoldableRanges，折叠无效是预期行为，非配置错误
一键折叠全部必须手动绑定命令
editor:fold-all 和 editor:unfold-all 是 Atom 内置命令，但没有默认快捷键。网上流传的 Ctrl+Shift+[ 实际多数版本未映射，也不可靠。
- 最稳定方式：
Ctrl+K Ctrl+0（Win/Linux）或Cmd+K Cmd+0（macOS）——它不依赖光标位置，直接作用于所有已识别折叠点 - 想自定义快捷键？打开
keymap.cson（菜单 → Atom → Keymap…），添加：'atom-text-editor:not([mini])': 'ctrl-alt-u': 'editor:unfold-all'
-
Ctrl+K Ctrl+1到Ctrl+K Ctrl+9可按缩进级别折叠（1 级 = 编辑器设置的缩进单位），适合分层收拢 - 注意：
editor:fold-all只收“语法认得”的块。例如旧版language-javascript不识别箭头函数体，而language-babel支持，但前提是文件后缀或 shebang 触发了它
// #region 折叠需要语言包原生支持，硬配 config.cson 很容易翻车
Atom 不原生支持 // #region 或 /* #region */。强行在 config.cson 里加 "source.js": ["region", "endregion"]，只会让编辑器把含这些词的行当作文本标记，不保证折叠行为正确。
- 优先安装带 region 支持的语言包：
language-babel、atom-typescript或language-vue（Vue SFC 中的 script 区） - 避免全局设置
foldingStrategy: "indent"——它会无视所有注释标记，只按空格/TAB 层级折叠，容易把 if 块和注释混折 -
fold-functions插件只对函数/类生效，不处理自定义 region；atom-fold-comment可补全注释块折叠，但不解决语法层缺失问题 - 改完
config.cson必须重启 Atom 才生效，且项目级差异大：同一份配置在 A 项目生效，在 B 项目可能因 language 包版本不同而失效
真正卡住人的从来不是“怎么按”，而是三个点没串起来：语言模式是否识别对、光标是否落进内容区、语法包是否真提供了折叠规则。缺一个，快捷键就只是个摆设。
