Atom折叠需光标位于可折叠结构内容区内，依赖语法包提供的折叠规则，一键折叠全部用Ctrl+K Ctrl+0，自定义#region需语言包支持，折叠状态默认不持久化。
折叠当前代码块，光标位置比快捷键更重要
Atom 不是“按了就折”，而是看光标是否落在可折叠结构的「内容区域」内。比如一个 function，光标必须在 { 和 } 之间（哪怕只在第一行函数体里），Ctrl+Alt+[（Win/Linux）或 Cmd+Option+[（macOS）才生效；停在函数声明行、空行、注释行或大括号外，基本没反应。
- 常见错误：按下后无响应、只折了一行、甚至把纯注释也“吞”进去了——大概率是语言模式没识别对，或语法包没提供折叠规则
- 确认右下角 language mode 显示的是
JavaScript、Python等，不是Plain Text -
YAML/TOML默认折叠支持弱，需确保启用了language-yaml等插件（新版通常自带） - 部分自定义后缀（如
.env、.spec.js）可能未注册getFoldableRanges，此时无效是预期行为，非配置错误
一键折叠全部，别靠默认快捷键
Atom 没有预设 editor:fold-all 的快捷键，但命令本身可用。最稳定的方式是 Ctrl+K Ctrl+0（Win/Linux）或 Cmd+K Cmd+0（macOS）——它不依赖语言包是否支持 #region，也不受光标位置限制，直接作用于当前文件所有已识别的折叠点。
-
Ctrl+Shift+[是常见误传，实际只作用于当前层级，且在多数 Atom 版本中未映射或已弃用 -
Ctrl+K Ctrl+1到Ctrl+K Ctrl+9可按缩进级别折叠（1 级 = 编辑器设置的缩进单位），适合分层收拢 - 想展开全部？用
Ctrl+K Ctrl+J（Win/Linux）或Cmd+K Cmd+J（macOS），比反复按展开键更可靠 - 若键盘是 AZERTY 布局，组合键可能异常，建议先用命令面板
Ctrl+Shift+P搜fold-all验证是否生效
自定义折叠（如 #region）需要语法层支持
Atom 的折叠不靠缩进自动判断，而是依赖语法包提供的 foldingStartMarker 和 foldingStopMarker 正则规则。想让 // #region 和 // #endregion 可折叠，不能只改 config.cson 加 "region"，得确保语言包真正实现了该逻辑。
- 优先安装带
#region支持的语言包，比如language-babel或language-typescript，而不是旧版language-javascript - 手动改
config.cson添加customFileTypes仅让 Atom 把含region的行当作文本标记，不保证折叠行为正确；改完必须重启 Atom - 避免全局设
foldingStrategy: "indent"——它会无视所有注释标记，只按空格/TAB 层级折，容易把if块和注释混折 - 插件如
fold-functions只对函数级生效，不认自定义region；atom-fold-comment可补全注释块折叠，但不解决语法层缺失问题
折叠状态不会跨会话保存，这不是 bug
关闭再打开同一个文件，之前手动折叠的块全恢复展开——这是 Atom 的设计选择，不是故障。折叠状态存在内存对象 displayLayer 中，不写入磁盘，也不随窗口布局一起恢复。
-
core.restorePreviousWindowOnStart: true只恢复窗口和 tab，不恢复折叠 - 真正持久化需借助插件：如
nuclide-file-tree（勾选Remember file folding state）或save-session（序列化displayLayer.folds到 JSON） - 注意：在超大文件（>10MB）中启用持久化可能拖慢打开速度
- 项目级差异明显：同一份
config.cson在 A 项目生效，在 B 项目失效，得逐个验证language-xxx是否启用且版本匹配
