Atom不支持注释自动换行，所谓换行实为Soft Wrap视觉折行；需确保语法识别正确、安装atomicchar插件（中文场景）、设置editor.preferredLineLength并启用softWrapAtPreferredLineLength。
Atom 本身不支持“注释自动换行”——它没有这个功能，所有相关尝试都会失败。你看到的换行效果，其实是 Soft Wrap（软换行）在起作用，而它对注释块是否折行，完全取决于当前文件类型、语法识别状态和配置细节。
为什么 Ctrl+/ 注释后不换行？
因为 Ctrl+/ 只是触发 editor:toggle-line-comments，它只在行首插入 // 或 #，不改变内容长度。如果注释内容本身超长（比如一整段文档字符串），是否折行由 Soft Wrap 控制，不是注释逻辑决定的。
- 确认右下角语法显示为正确类型（如
Python、JavaScript），不是Plain text；否则Soft Wrap可能被语言包禁用 - 检查
config.cson是否有针对该 grammar 的覆盖项，例如："source.python": {"softWrap": false} - 长注释行若含连续无空格字符（如 URL、base64 片段），
Soft Wrap默认不在此类位置断行，需配合editor.preferredLineLength和editor.softWrapAtPreferredLineLength: true
HTML/Markdown 注释里怎么让 <!-- long comment --> 折行？
这类块注释本身是单行结构，Soft Wrap 对它生效的前提是：整段注释被识别为文本内容而非 HTML 标签。但 Atom 的 language-html 包默认把 <!-- ... --> 当作独立语法节点处理，导致折行逻辑失效。
- 临时方案：手动在注释内加空格或
-，例如<!-- this-is-a-very-long-comment -->→ 拆成<!-- this-is-a-very-long-comment -->中间插入空格 - 更稳做法：改用 Markdown 文件写说明，用普通段落替代 HTML 注释，
Soft Wrap对纯文本段落支持更好 - 别依赖
autoclose-html或atom-beautify来“修复”注释换行——它们不处理渲染层折行
中文注释为何完全不折行？
Atom 默认按 Unicode 断行规则，在连续汉字间不插入软换行点。哪怕开了 Soft Wrap，一整段中文也会顶到右边，看起来像“没反应”。
- 必须安装
atomicchar插件并重启 Atom，它会主动在中文字符间插入合法断行机会 - 装完后仍不生效？检查是否启用了其他冲突插件（如
markdown-preview-plus），它的预览区不继承编辑器的atomicchar行为 - 注意：
atomicchar不影响实际换行符，复制出来的仍是单行；也对script或style块内的注释无效
真正容易被忽略的是：你调了半天 Soft Wrap 参数，却没意识到 Atom 对「注释」本身不做特殊处理——它只是把注释当普通文本渲染。想让长注释可读，核心不是找“注释换行开关”，而是确保语法识别准确 + atomicchar 就位 + preferredLineLength 设得合理。
