Atom代码折叠依赖光标位于可折叠结构内容区内，非默认支持全部折叠需用Ctrl+K Ctrl+0，折叠状态不持久化，自定义#region折叠可能影响语法高亮。
折叠当前代码块，光标位置比快捷键更重要
Atom 的代码折叠不是“按了就折”，而是依赖光标是否落在可折叠结构的「内容区域」内。比如一个 function 块，光标必须在 { 和 } 之间（哪怕只在第一行函数体里），才能触发折叠；停在函数声明行、大括号外、空行或注释行，Ctrl+Alt+[（Windows/Linux）或 Cmd+Option+[（macOS）大概率没反应。
常见错误现象包括：按下后无响应、只折了一行、甚至把纯注释也“吞”进去了——这基本说明语言模式没识别对，或当前语法不支持自动折叠。
- 确认右下角 language mode 显示的是
JavaScript、Python等，不是Plain Text - YAML/TOML 等格式默认折叠支持较弱，需确保已安装并启用
language-yaml等插件（新版通常自带） - 部分自定义语法（如 .env、.spec.js）可能未注册
getFoldableRanges，此时折叠无效是预期行为，非配置错误
一键折叠全部代码，别靠记忆快捷键
Atom 没有默认绑定「全部折叠」的快捷键，但命令是存在的：editor:fold-all 和 editor:unfold-all。直接按 Ctrl+K Ctrl+0（Windows/Linux）或 Cmd+K Cmd+0（macOS）能快速触发前者，这是最稳定、兼容性最好的方式。
注意：Ctrl+Shift+[ 在部分旧版文档中被误传为全局折叠键，实际它只作用于当前层级，且在多数 Atom 版本中已被弃用或未映射。
-
Ctrl+K Ctrl+1到Ctrl+K Ctrl+9可按缩进级别折叠（1 级=4 空格/1 Tab，依编辑器设置而定） - 想展开所有折叠？用
Ctrl+K Ctrl+J（Windows/Linux）或Cmd+K Cmd+J（macOS），比反复按展开键更可靠 - 这些
Ctrl+K组合键在键盘布局为 AZERTY 的机器上可能需额外适配，建议优先通过命令面板（Ctrl+Shift+P）搜fold-all验证是否生效
折叠状态不会跨会话保存，除非你改过配置
Atom 默认不持久化折叠状态——关掉文件再重开，所有折叠都会重置。这不是 bug，是设计选择。如果你依赖折叠结构辅助阅读（比如长期维护一个巨长的配置文件），就得手动开启序列化。
折叠状态由 displayLayer 管理，底层调用的是 foldBufferRange(range)，但默认不写入磁盘。要让它记住，得在 config.cson 中加一行：
core: restorePreviousWindowOnStart: true
但这只恢复窗口布局，不恢复折叠。真正起效的是启用 save-session 类插件，或使用官方推荐的 project-manager 配合自定义序列化逻辑——不过要注意，过度保存折叠状态在超大文件（>10MB）中可能拖慢打开速度。
自定义折叠区域，小心语法高亮冲突
Atom 支持用特殊注释标记自定义折叠块，例如在 JavaScript 中写：
// #region 初始化逻辑 const a = 1; // #endregion
这类折叠依赖语言包是否实现了 getFoldableRanges 的 region 解析。不是所有语言包都支持，比如原生 language-python 就不认 #region，但装了 python-tools 插件后可以。
容易被忽略的一点是：自定义折叠区域一旦启用，其内部的语法高亮可能失效——因为 Atom 会把整块当作文本片段处理，跳过逐行 tokenization。如果发现折叠后变量名突然不着色了，先检查是不是 region 标记触发了降级解析。
另外，// #region 这种写法在 ESLint 或 Prettier 下可能报错，建议仅用于临时调试，勿提交到主干。
