Atom Autoflow 包实战指南Reflow Selection 命令与段落重排算法解析【免费下载链接】atom:atom: The hackable text editor项目地址: https://gitcode.com/gh_mirrors/at/atomAutoflow 是 Atom 内置的一个文本重排reflow包选中一段文本后按一个快捷键即可把选区内的所有段落按配置的行宽重新换行未选中任何内容时则自动重排当前段落。本文基于 packages/autoflow/README.md 展开结合 核心实现、键位配置、配置模式定义 与 完整测试集讲清楚这条命令的触发方式、两个关键配置项、以及底层重排算法处理缩进、注释前缀、LaTeX 标签和超长单词的细节读完你可以理解 Atom 中“段落重排”类功能是如何用不到 150 行 CoffeeScript 实现的。一、Autoflow 是什么功能定义与触发方式README 对 Autoflow 的定义非常精炼将当前选区格式化为每行不超过 80 字符。macOS 上使用cmd-alt-qWindows 与 Linux 上使用ctrl-shift-q。如果没有选中文本则重排当前段落。如果设置了editor.preferredLineLength配置项则用它的值决定目标行宽。这与 package.json 中的描述一致{ name: autoflow, main: ./lib/autoflow, description: Format the current selection to have lines no longer than 80 characters.\n\nThis packages uses the config value of editor.preferredLineLength when set., activationCommands: { atom-text-editor: [ autoflow:reflow-selection ] } }从源码结构看这个包提供了两种触发入口快捷键keymaps/autoflow.cson 按平台分发。macOS.platform-darwin绑定alt-cmd-qWindows/Linux.platform-win32、.platform-linux绑定ctrl-shift-q两者都派发autoflow:reflow-selection命令且都限定在atom-text-editor元素上生效菜单栏menus/autoflow.cson 在 Edit 菜单下注入 “Reflow Selection” 条目同样指向autoflow:reflow-selection。包自身的激活/注销逻辑在 autoflow.coffeeactivate: - commandDisposable atom.commands.add atom-text-editor, autoflow:reflow-selection: (event) reflowSelection(event.currentTarget.getModel()) deactivate: - commandDisposable?.dispose() commandDisposable null注意activationCommands的写法包不会在 Atom 启动时提前加载只有当用户首次在编辑器上按下快捷键或点击菜单时才会被激活命令监听器注册在atom-text-editor选择器上event.currentTarget.getModel()拿到的就是命令被派发时那个编辑器的TextEditor模型。这是一个非常典型的“懒加载包”结构也意味着 Autoflow 不依赖任何原生模块唯一的外部依赖是 package.json 中声明的underscore-plus仅用于把注释前缀转义成正则见下文。二、两个决定行为的关键配置项Autoflow 的行为完全由编辑器的两个配置项驱动读取代码在 autoflow.coffeegetTabLength: (editor) - atom.config.get(editor.tabLength, scope: editor.getRootScopeDescriptor()) ? 2 getPreferredLineLength: (editor) - atom.config.get(editor.preferredLineLength, scope: editor.getRootScopeDescriptor())两个配置项在 config-schema.js 中的定义如下配置项类型默认值最小值作用editor.preferredLineLengthinteger801目标行宽字符数用于软换行达到指定行宽的设置也被 Autoflow 用作重排的 wrap columneditor.tabLengthinteger21一个 Tab 字符折算成的空格数两个实现细节值得注意读取时带上了编辑器作用域。atom.config.get(..., scope: editor.getRootScopeDescriptor())表示会沿当前编辑器语言的作用域链scope selector 链逐级查找配置因此可以为特定语言单独设置行宽。spec/text-editor-registry-spec.js 中就有preferredLineLength随编辑器作用域动态更新的验证。Autoflow 自己的测试也覆盖了这一点autoflow-spec.coffeeit uses the preferred line length based on the editors scope, - atom.config.set(editor.preferredLineLength, 4, scopeSelector: .text.plain.null-grammar) editor.setText(foo bar) editor.selectAll() atom.commands.dispatch editorElement, autoflow:reflow-selection expect(editor.getText()).toBe foo bar 仓库中就有真实的语言级定制案例language-rust-bundled/settings/rust.cson 为 Rust 语法设置了preferredLineLength: 99所以在 Rust 文件中执行 Autoflow 时目标行宽是 99 而不是全局的 80。Tab 宽度的作用。重排不是简单地按“字符数”截断而是把行首前缀中的 Tab 展开成tabLength个空格来计算实际宽度源码中tabLengthInSpaces Array(tabLength 1).join( )从而保证带缩进、带注释前缀的段落重排后视觉上仍然对齐。测试用tabLength 4验证了这一点两段以\t\t开头的长文本重排后每行前缀占 8 列正文在剩余宽度内换行autoflow-spec.coffee。另外preferredLineLength还是 Atom 编辑器内置属性src/text-editor-registry.js 把它映射为编辑器的preferredLineLength属性与softWrapAtPreferredLineLength配合用于软换行显示。Autoflow 复用同一个数值但它是真实改写缓冲区文本硬换行而不是仅仅在视口里折行——两者不冲突可以各用各的。三、命令入口如何确定要重排的文本范围核心入口方法reflowSelection只有 9 行autoflow.coffeereflowSelection: (editor) - range editor.getSelectedBufferRange() range editor.getCurrentParagraphBufferRange() if range.isEmpty() return unless range? reflowOptions wrapColumn: getPreferredLineLength(editor) tabLength: getTabLength(editor) reflowedText reflow(editor.getTextInRange(range), reflowOptions) editor.getBuffer().setTextInRange(range, reflowedText)流程是取选区的 buffer range → 若为空则退化为“当前段落”的 range → 读出该范围文本 → 交给纯函数reflow处理 → 把结果写回同一个范围。整个过程中没有触碰视图层只在TextBuffer上做一次setTextInRange这也是它能被atom.commands.dispatch在测试里直接驱动的原因。“当前段落”是如何划定的当没有选区时调用的editor.getCurrentParagraphBufferRange()定义在 src/text-editor.js它委托给最后一个光标src/cursor.js最终落到 rowRangeForParagraphAtBufferRowrowRangeForParagraphAtBufferRow(bufferRow) { if (!NON_WHITESPACE_REGEXP.test(this.lineTextForBufferRow(bufferRow))) return; const languageMode this.buffer.getLanguageMode(); const isCommented languageMode.isRowCommented(bufferRow); let startRow bufferRow; while (startRow 0) { if (!NON_WHITESPACE_REGEXP.test(this.lineTextForBufferRow(startRow - 1))) break; if (languageMode.isRowCommented(startRow - 1) ! isCommented) break; startRow--; } let endRow bufferRow; const rowCount this.getLineCount(); while (endRow 1 rowCount) { if (!NON_WHITESPACE_REGEXP.test(this.lineTextForBufferRow(endRow 1))) break; if (languageMode.isRowCommented(endRow 1) ! isCommented) break; endRow; } ... }从实现可以看出 Atom 对“段落”的定义源码注释也写明 “A paragraph is defined as a block of text surrounded by empty lines or comments”光标所在行必须是非空白行否则直接返回undefinedreflowSelection随即return unless range?不做任何事向上、向下逐行扩展直到遇到空行或者注释状态发生切换正文行 ↔ 注释行由语言模式isRowCommented判断。这个“注释边界”设计让 Autoflow 对注释块天然友好一段连续的//注释会与后面的正文分开各自作为独立段落处理。对应的测试是 autoflow-spec.coffee 的 “reflows the current paragraph if nothing is selected”光标停在中间段落第 5 列执行命令后只重排该段落前后段落包括首尾的长行原样保留。测试还专门覆盖了选区边界落在段落之间的尴尬情况autoflow-spec.coffee选区起点恰好在新段落首行、终点在旧段落末行之后时选区内部会混入段落间的换行重排后段前换行不被吞掉、段尾换行也不会被错误地转成空格。这一行为由下文要讲的“首尾垂直空白保留”逻辑保证。四、重排算法详解reflow方法逐段解读reflow(text, {wrapColumn, tabLength})是纯文本函数autoflow.coffee这也是测试可以直接require(../lib/autoflow)后绕过编辑器 UI 逐用例断言的原因autoflow-spec.coffee。整个算法分为六个阶段。1. 换行符归一化与首尾空白保护# Convert all \r\n and \r to \n. The text buffer will normalize them later text text.replace(/\r\n?/g, \n) leadingVerticalSpace text.match(/^\s*\n/) ... trailingVerticalSpace text.match(/\n\s*$/)先把\r\n、\r统一成\n测试 “properly handles CRLF” 混合了两种换行风格并验证了结果再把选区开头到第一个换行前、最后一个换行后到结尾的垂直空白整块摘除、留待最后拼回去。这是“选区边界在段落之间”不被破坏的关键——段落之间的那个换行属于边界空白不参与重排。2. 按空行切分段落paragraphBlocks text.split(/\n\s*\n/g)用“换行 任意中间空白 换行”把文本切成段落块每块独立重排最后用\n\n重新连接return leadingVerticalSpace paragraphs.join(\n\n) trailingVerticalSpace。所以Autoflow 绝不会把两个段落合并也保证段间恰好一个空行。3. LaTeX 环境标签的识别与“原样保留”每个段落块处理前先从首尾剥离 LaTeX 环境标签行autoflow.coffeelatexTagRegex /^\s*\\\w(\[.*\])?\{\w\}(\[.*\])?\s*$/g # e.g. \begin{verbatim} latexTagStartRegex /^\s*\\\w\s*\{\s*$/g # e.g. \item{ latexTagEndRegex /^\s*\}\s*$/g # e.g. }开头凡是匹配“完整环境行”\begin{verbatim}之类或“未闭合的\xxx{”的行依次挪进beginningLinesToIgnore结尾凡是匹配完整环境行或孤立的}的行依次挪进endingLinesToIgnore。这些行不参与换行计算重排完成后原样拼回首尾。对应测试有三组\begin{verbatim}...\end{verbatim}之间换行、\item{ ... }内部换行、嵌套\begin{enumerate}...\item{...}...\end{enumerate}内换行autoflow-spec.coffee以及“段内只有\begin{enumerate}\end{enumerate}两个标签、没有任何正文时原样返回”的边界情况。4. 注释/列表前缀的识别linePrefix blockLines[0].match(/^\s*(\/\/|\/\*|;;|#|\|\|\||--|[#%*-])?\s*/g)[0]取段落首行匹配出的前缀作为整段的统一前缀然后从每一行剥掉它、再剥掉行首剩余空白把段落变成“纯文本”去重排。从字符类可以看出 Autoflow 能识别的行前缀族谱源码注释也提醒-必须放在字符类最后前缀典型场景//C/C/Java/JS/TS 单行注释/*C 风格块注释首行;;Lisp/Clojure 等#R 的 roxygen 注释\|\|\|Elixir 等--Haskell/Lua/SQL#%*-Shell/Python/Matlab、邮件引用、LaTeX 注释、*星号列表、-短横线列表一个容易踩坑的细节是单个;不被视为注释前缀必须是;;测试 “does not treat lines starting with a single semicolon as ;; comments” 专门验证;!开头的行只保留首行前缀、续行不加前缀autoflow-spec.coffee。剥前缀时用了_.escapeRegExp(linePrefix)autoflow.coffee这解释了测试 “does not throw invalid regular expression errors (regression)”像***这种包含正则元字符的前缀不会把replace炸掉而是被安全转义后处理该用例中文本无第二行可重排结果保持原样。前缀的宽度参与换行计算前还会做一次 Tab 展开linePrefixTabExpanded linePrefix if tabLengthInSpaces linePrefixTabExpanded linePrefix.replace(/\t/g, tabLengthInSpaces)即currentLineLength的初始值就是linePrefixTabExpanded.length续行同样以这个值为起点累计——这就是第二节中 Tab 配置生效的位置。5. 分段与换行判定segmentTextwrapSegment剥掉前缀后段落被拼回单个字符串再切成“段”segmentsegmentText: (text) - segments [] re /[\s]|[^\s]/g segments.push(match[0]) while match re.exec(text) segments即交替切出“空白串”和“非空白串”单词。换行决策函数只有 4 行autoflow.coffeewrapSegment: (segment, currentLineLength, wrapColumn) - CharacterPattern.test(segment) and (currentLineLength segment.length wrapColumn) and (currentLineLength 0 or segment.length wrapColumn)其中CharacterPattern是/^\s/。三个条件合起来读就是只有空白开头的段即一个词后面的空格才可能是换行点——换行永远发生在词与词之间加上这个段连同其中的空格会超出 wrapColumn才换行第三个条件处理超长单词当前行为空、而单个非空白段本身已超过 wrapColumn 时不换行让它整词落在本行。对应测试 “allows for single words that exceed the preferred wrap column length”this-is-a-super-long-word-that-shouldnt-break-autoflow约 52 字符在 wrapColumn30 下单独占一行后面的普通单词正常重排autoflow-spec.coffee。Autoflow 从不撕裂单词。主循环把每段依次放入currentLine并累计长度autoflow.coffee每形成一行就 push 出去。对续行前缀还有两处特殊处理autoflow.coffeewrappedLinePrefix linePrefix .replace(/^(\s*)\/\*/, $1 ) .replace(/^(\s*)-(?!-)/, $1 )/*开头的 C 块注释续行把/*换成两个空格使闭合的*/视觉对齐——测试 “properly reflows /* comments” 的结果正是/*在首行、续行以两个空格缩进单个-短横线列表项但--除外靠(?!-)负向断言区分续行把-换成空格形成 Markdown 列表的悬挂缩进——测试 “properly reflows - list items” 可验证。其余前缀//、#、%、;;、、#、|||等续行原样重复该前缀。测试集对每一类前缀都有完整的 80 列重排用例autoflow-spec.coffee覆盖//、/*、#、%、#、--、|||、;;、等。6. 收尾LaTeX 标签拼回与行尾空白清理wrappedLines beginningLinesToIgnore.concat(lines.concat(endingLinesToIgnore)) paragraphs.push(wrappedLines.join(\n).replace(/\s\n/g, \n))最后一步把首尾保留的 LaTeX 标签行拼回去并用replace(/\s\n/g, \n)清掉续行行尾可能残留的空白。五、行为边界与测试依据spec/autoflow-spec.coffee 共 2000 余行是这个包最重要的“可验证依据”。按主题归类后它确认了以下行为边界配置读取editor.preferredLineLength支持按 scope selector 细化到具体语言作用域Tab 语义前缀中的 Tab 按editor.tabLength展开为等宽空格参与宽度计算选区语义空选区只重排光标所在段落选区跨段落时段间换行保留段内文本全部重排超长单词不拆词单独成行换行风格\r\n与\r混用也能正确归一化UnicodeCyrillic 文本与特殊字符Ё的重排都有专例后者备注了主流正则引擎对该字符的历史问题LaTeX环境标签行原样保留、标签内部正常换行、纯标签段落不处理特殊字符不越界“doesnt allow special characters to surpass wrapColumn” 用例用一段含$...$数学公式和“句尾%”的 LaTeX 混排文本验证像%、$这类符号既不会误触发注释前缀逻辑也不会让任何一行超过 80 列。六、使用建议与限制说明结合源码可以给出几条实操层面的结论均以上述文件为依据触发方式macOS 按alt-cmd-qWindows/Linux 按ctrl-shift-q或 Edit 菜单的 “Reflow Selection”。命令是惰性的首次触发才激活包。改行宽全局改editor.preferredLineLength默认 80最小 1或在config.cson里按语言作用域覆盖例如仓库自带的 Rust 做法source.rust: preferredLineLength: 99改 Tab 宽度editor.tabLength默认 2影响带缩进文本重排后的对齐精度尤其是注释前缀里含 Tab 的段落。已知限制注释前缀识别基于首行启发式匹配源码中也有TODO: this could be more language specific. Use the actual comment char.的注释autoflow.coffee即它并非按语言的真实注释语法判断换行点只能落在词间空白处超宽单词整词成行段落内若混用不同前缀如首行//中间某行#只有首行前缀会被剥离和重复这是该算法的设计取舍重排是写缓冲区的硬换行操作与视图层的软换行softWrap/softWrapAtPreferredLineLength是两套机制互不替代。小结Autoflow 虽然只是 Atom 内置包中最小的一批之一但它的实现链路非常完整键位与菜单把autoflow:reflow-selection命令接到TextEditor模型reflowSelection 用选区或 段落范围 划定范围reflow 纯函数按“归一化换行 → 保护首尾空白 → 空行切段 → 识别 LaTeX 标签与注释前缀 → 按词分段换行 → 拼回前缀标签”六步完成重排行宽与 Tab 宽度均来自带作用域的配置项editor.preferredLineLength和editor.tabLength。spec 目录下的测试 对每个阶段都有独立断言是阅读这个重排算法时最可靠的参照。【免费下载链接】atom:atom: The hackable text editor项目地址: https://gitcode.com/gh_mirrors/at/atom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Atom Autoflow 包实战指南：Reflow Selection 命令与段落重排算法解析
Atom Autoflow 包实战指南Reflow Selection 命令与段落重排算法解析【免费下载链接】atom:atom: The hackable text editor项目地址: https://gitcode.com/gh_mirrors/at/atomAutoflow 是 Atom 内置的一个文本重排reflow包选中一段文本后按一个快捷键即可把选区内的所有段落按配置的行宽重新换行未选中任何内容时则自动重排当前段落。本文基于 packages/autoflow/README.md 展开结合 核心实现、键位配置、配置模式定义 与 完整测试集讲清楚这条命令的触发方式、两个关键配置项、以及底层重排算法处理缩进、注释前缀、LaTeX 标签和超长单词的细节读完你可以理解 Atom 中“段落重排”类功能是如何用不到 150 行 CoffeeScript 实现的。一、Autoflow 是什么功能定义与触发方式README 对 Autoflow 的定义非常精炼将当前选区格式化为每行不超过 80 字符。macOS 上使用cmd-alt-qWindows 与 Linux 上使用ctrl-shift-q。如果没有选中文本则重排当前段落。如果设置了editor.preferredLineLength配置项则用它的值决定目标行宽。这与 package.json 中的描述一致{ name: autoflow, main: ./lib/autoflow, description: Format the current selection to have lines no longer than 80 characters.\n\nThis packages uses the config value of editor.preferredLineLength when set., activationCommands: { atom-text-editor: [ autoflow:reflow-selection ] } }从源码结构看这个包提供了两种触发入口快捷键keymaps/autoflow.cson 按平台分发。macOS.platform-darwin绑定alt-cmd-qWindows/Linux.platform-win32、.platform-linux绑定ctrl-shift-q两者都派发autoflow:reflow-selection命令且都限定在atom-text-editor元素上生效菜单栏menus/autoflow.cson 在 Edit 菜单下注入 “Reflow Selection” 条目同样指向autoflow:reflow-selection。包自身的激活/注销逻辑在 autoflow.coffeeactivate: - commandDisposable atom.commands.add atom-text-editor, autoflow:reflow-selection: (event) reflowSelection(event.currentTarget.getModel()) deactivate: - commandDisposable?.dispose() commandDisposable null注意activationCommands的写法包不会在 Atom 启动时提前加载只有当用户首次在编辑器上按下快捷键或点击菜单时才会被激活命令监听器注册在atom-text-editor选择器上event.currentTarget.getModel()拿到的就是命令被派发时那个编辑器的TextEditor模型。这是一个非常典型的“懒加载包”结构也意味着 Autoflow 不依赖任何原生模块唯一的外部依赖是 package.json 中声明的underscore-plus仅用于把注释前缀转义成正则见下文。二、两个决定行为的关键配置项Autoflow 的行为完全由编辑器的两个配置项驱动读取代码在 autoflow.coffeegetTabLength: (editor) - atom.config.get(editor.tabLength, scope: editor.getRootScopeDescriptor()) ? 2 getPreferredLineLength: (editor) - atom.config.get(editor.preferredLineLength, scope: editor.getRootScopeDescriptor())两个配置项在 config-schema.js 中的定义如下配置项类型默认值最小值作用editor.preferredLineLengthinteger801目标行宽字符数用于软换行达到指定行宽的设置也被 Autoflow 用作重排的 wrap columneditor.tabLengthinteger21一个 Tab 字符折算成的空格数两个实现细节值得注意读取时带上了编辑器作用域。atom.config.get(..., scope: editor.getRootScopeDescriptor())表示会沿当前编辑器语言的作用域链scope selector 链逐级查找配置因此可以为特定语言单独设置行宽。spec/text-editor-registry-spec.js 中就有preferredLineLength随编辑器作用域动态更新的验证。Autoflow 自己的测试也覆盖了这一点autoflow-spec.coffeeit uses the preferred line length based on the editors scope, - atom.config.set(editor.preferredLineLength, 4, scopeSelector: .text.plain.null-grammar) editor.setText(foo bar) editor.selectAll() atom.commands.dispatch editorElement, autoflow:reflow-selection expect(editor.getText()).toBe foo bar 仓库中就有真实的语言级定制案例language-rust-bundled/settings/rust.cson 为 Rust 语法设置了preferredLineLength: 99所以在 Rust 文件中执行 Autoflow 时目标行宽是 99 而不是全局的 80。Tab 宽度的作用。重排不是简单地按“字符数”截断而是把行首前缀中的 Tab 展开成tabLength个空格来计算实际宽度源码中tabLengthInSpaces Array(tabLength 1).join( )从而保证带缩进、带注释前缀的段落重排后视觉上仍然对齐。测试用tabLength 4验证了这一点两段以\t\t开头的长文本重排后每行前缀占 8 列正文在剩余宽度内换行autoflow-spec.coffee。另外preferredLineLength还是 Atom 编辑器内置属性src/text-editor-registry.js 把它映射为编辑器的preferredLineLength属性与softWrapAtPreferredLineLength配合用于软换行显示。Autoflow 复用同一个数值但它是真实改写缓冲区文本硬换行而不是仅仅在视口里折行——两者不冲突可以各用各的。三、命令入口如何确定要重排的文本范围核心入口方法reflowSelection只有 9 行autoflow.coffeereflowSelection: (editor) - range editor.getSelectedBufferRange() range editor.getCurrentParagraphBufferRange() if range.isEmpty() return unless range? reflowOptions wrapColumn: getPreferredLineLength(editor) tabLength: getTabLength(editor) reflowedText reflow(editor.getTextInRange(range), reflowOptions) editor.getBuffer().setTextInRange(range, reflowedText)流程是取选区的 buffer range → 若为空则退化为“当前段落”的 range → 读出该范围文本 → 交给纯函数reflow处理 → 把结果写回同一个范围。整个过程中没有触碰视图层只在TextBuffer上做一次setTextInRange这也是它能被atom.commands.dispatch在测试里直接驱动的原因。“当前段落”是如何划定的当没有选区时调用的editor.getCurrentParagraphBufferRange()定义在 src/text-editor.js它委托给最后一个光标src/cursor.js最终落到 rowRangeForParagraphAtBufferRowrowRangeForParagraphAtBufferRow(bufferRow) { if (!NON_WHITESPACE_REGEXP.test(this.lineTextForBufferRow(bufferRow))) return; const languageMode this.buffer.getLanguageMode(); const isCommented languageMode.isRowCommented(bufferRow); let startRow bufferRow; while (startRow 0) { if (!NON_WHITESPACE_REGEXP.test(this.lineTextForBufferRow(startRow - 1))) break; if (languageMode.isRowCommented(startRow - 1) ! isCommented) break; startRow--; } let endRow bufferRow; const rowCount this.getLineCount(); while (endRow 1 rowCount) { if (!NON_WHITESPACE_REGEXP.test(this.lineTextForBufferRow(endRow 1))) break; if (languageMode.isRowCommented(endRow 1) ! isCommented) break; endRow; } ... }从实现可以看出 Atom 对“段落”的定义源码注释也写明 “A paragraph is defined as a block of text surrounded by empty lines or comments”光标所在行必须是非空白行否则直接返回undefinedreflowSelection随即return unless range?不做任何事向上、向下逐行扩展直到遇到空行或者注释状态发生切换正文行 ↔ 注释行由语言模式isRowCommented判断。这个“注释边界”设计让 Autoflow 对注释块天然友好一段连续的//注释会与后面的正文分开各自作为独立段落处理。对应的测试是 autoflow-spec.coffee 的 “reflows the current paragraph if nothing is selected”光标停在中间段落第 5 列执行命令后只重排该段落前后段落包括首尾的长行原样保留。测试还专门覆盖了选区边界落在段落之间的尴尬情况autoflow-spec.coffee选区起点恰好在新段落首行、终点在旧段落末行之后时选区内部会混入段落间的换行重排后段前换行不被吞掉、段尾换行也不会被错误地转成空格。这一行为由下文要讲的“首尾垂直空白保留”逻辑保证。四、重排算法详解reflow方法逐段解读reflow(text, {wrapColumn, tabLength})是纯文本函数autoflow.coffee这也是测试可以直接require(../lib/autoflow)后绕过编辑器 UI 逐用例断言的原因autoflow-spec.coffee。整个算法分为六个阶段。1. 换行符归一化与首尾空白保护# Convert all \r\n and \r to \n. The text buffer will normalize them later text text.replace(/\r\n?/g, \n) leadingVerticalSpace text.match(/^\s*\n/) ... trailingVerticalSpace text.match(/\n\s*$/)先把\r\n、\r统一成\n测试 “properly handles CRLF” 混合了两种换行风格并验证了结果再把选区开头到第一个换行前、最后一个换行后到结尾的垂直空白整块摘除、留待最后拼回去。这是“选区边界在段落之间”不被破坏的关键——段落之间的那个换行属于边界空白不参与重排。2. 按空行切分段落paragraphBlocks text.split(/\n\s*\n/g)用“换行 任意中间空白 换行”把文本切成段落块每块独立重排最后用\n\n重新连接return leadingVerticalSpace paragraphs.join(\n\n) trailingVerticalSpace。所以Autoflow 绝不会把两个段落合并也保证段间恰好一个空行。3. LaTeX 环境标签的识别与“原样保留”每个段落块处理前先从首尾剥离 LaTeX 环境标签行autoflow.coffeelatexTagRegex /^\s*\\\w(\[.*\])?\{\w\}(\[.*\])?\s*$/g # e.g. \begin{verbatim} latexTagStartRegex /^\s*\\\w\s*\{\s*$/g # e.g. \item{ latexTagEndRegex /^\s*\}\s*$/g # e.g. }开头凡是匹配“完整环境行”\begin{verbatim}之类或“未闭合的\xxx{”的行依次挪进beginningLinesToIgnore结尾凡是匹配完整环境行或孤立的}的行依次挪进endingLinesToIgnore。这些行不参与换行计算重排完成后原样拼回首尾。对应测试有三组\begin{verbatim}...\end{verbatim}之间换行、\item{ ... }内部换行、嵌套\begin{enumerate}...\item{...}...\end{enumerate}内换行autoflow-spec.coffee以及“段内只有\begin{enumerate}\end{enumerate}两个标签、没有任何正文时原样返回”的边界情况。4. 注释/列表前缀的识别linePrefix blockLines[0].match(/^\s*(\/\/|\/\*|;;|#|\|\|\||--|[#%*-])?\s*/g)[0]取段落首行匹配出的前缀作为整段的统一前缀然后从每一行剥掉它、再剥掉行首剩余空白把段落变成“纯文本”去重排。从字符类可以看出 Autoflow 能识别的行前缀族谱源码注释也提醒-必须放在字符类最后前缀典型场景//C/C/Java/JS/TS 单行注释/*C 风格块注释首行;;Lisp/Clojure 等#R 的 roxygen 注释\|\|\|Elixir 等--Haskell/Lua/SQL#%*-Shell/Python/Matlab、邮件引用、LaTeX 注释、*星号列表、-短横线列表一个容易踩坑的细节是单个;不被视为注释前缀必须是;;测试 “does not treat lines starting with a single semicolon as ;; comments” 专门验证;!开头的行只保留首行前缀、续行不加前缀autoflow-spec.coffee。剥前缀时用了_.escapeRegExp(linePrefix)autoflow.coffee这解释了测试 “does not throw invalid regular expression errors (regression)”像***这种包含正则元字符的前缀不会把replace炸掉而是被安全转义后处理该用例中文本无第二行可重排结果保持原样。前缀的宽度参与换行计算前还会做一次 Tab 展开linePrefixTabExpanded linePrefix if tabLengthInSpaces linePrefixTabExpanded linePrefix.replace(/\t/g, tabLengthInSpaces)即currentLineLength的初始值就是linePrefixTabExpanded.length续行同样以这个值为起点累计——这就是第二节中 Tab 配置生效的位置。5. 分段与换行判定segmentTextwrapSegment剥掉前缀后段落被拼回单个字符串再切成“段”segmentsegmentText: (text) - segments [] re /[\s]|[^\s]/g segments.push(match[0]) while match re.exec(text) segments即交替切出“空白串”和“非空白串”单词。换行决策函数只有 4 行autoflow.coffeewrapSegment: (segment, currentLineLength, wrapColumn) - CharacterPattern.test(segment) and (currentLineLength segment.length wrapColumn) and (currentLineLength 0 or segment.length wrapColumn)其中CharacterPattern是/^\s/。三个条件合起来读就是只有空白开头的段即一个词后面的空格才可能是换行点——换行永远发生在词与词之间加上这个段连同其中的空格会超出 wrapColumn才换行第三个条件处理超长单词当前行为空、而单个非空白段本身已超过 wrapColumn 时不换行让它整词落在本行。对应测试 “allows for single words that exceed the preferred wrap column length”this-is-a-super-long-word-that-shouldnt-break-autoflow约 52 字符在 wrapColumn30 下单独占一行后面的普通单词正常重排autoflow-spec.coffee。Autoflow 从不撕裂单词。主循环把每段依次放入currentLine并累计长度autoflow.coffee每形成一行就 push 出去。对续行前缀还有两处特殊处理autoflow.coffeewrappedLinePrefix linePrefix .replace(/^(\s*)\/\*/, $1 ) .replace(/^(\s*)-(?!-)/, $1 )/*开头的 C 块注释续行把/*换成两个空格使闭合的*/视觉对齐——测试 “properly reflows /* comments” 的结果正是/*在首行、续行以两个空格缩进单个-短横线列表项但--除外靠(?!-)负向断言区分续行把-换成空格形成 Markdown 列表的悬挂缩进——测试 “properly reflows - list items” 可验证。其余前缀//、#、%、;;、、#、|||等续行原样重复该前缀。测试集对每一类前缀都有完整的 80 列重排用例autoflow-spec.coffee覆盖//、/*、#、%、#、--、|||、;;、等。6. 收尾LaTeX 标签拼回与行尾空白清理wrappedLines beginningLinesToIgnore.concat(lines.concat(endingLinesToIgnore)) paragraphs.push(wrappedLines.join(\n).replace(/\s\n/g, \n))最后一步把首尾保留的 LaTeX 标签行拼回去并用replace(/\s\n/g, \n)清掉续行行尾可能残留的空白。五、行为边界与测试依据spec/autoflow-spec.coffee 共 2000 余行是这个包最重要的“可验证依据”。按主题归类后它确认了以下行为边界配置读取editor.preferredLineLength支持按 scope selector 细化到具体语言作用域Tab 语义前缀中的 Tab 按editor.tabLength展开为等宽空格参与宽度计算选区语义空选区只重排光标所在段落选区跨段落时段间换行保留段内文本全部重排超长单词不拆词单独成行换行风格\r\n与\r混用也能正确归一化UnicodeCyrillic 文本与特殊字符Ё的重排都有专例后者备注了主流正则引擎对该字符的历史问题LaTeX环境标签行原样保留、标签内部正常换行、纯标签段落不处理特殊字符不越界“doesnt allow special characters to surpass wrapColumn” 用例用一段含$...$数学公式和“句尾%”的 LaTeX 混排文本验证像%、$这类符号既不会误触发注释前缀逻辑也不会让任何一行超过 80 列。六、使用建议与限制说明结合源码可以给出几条实操层面的结论均以上述文件为依据触发方式macOS 按alt-cmd-qWindows/Linux 按ctrl-shift-q或 Edit 菜单的 “Reflow Selection”。命令是惰性的首次触发才激活包。改行宽全局改editor.preferredLineLength默认 80最小 1或在config.cson里按语言作用域覆盖例如仓库自带的 Rust 做法source.rust: preferredLineLength: 99改 Tab 宽度editor.tabLength默认 2影响带缩进文本重排后的对齐精度尤其是注释前缀里含 Tab 的段落。已知限制注释前缀识别基于首行启发式匹配源码中也有TODO: this could be more language specific. Use the actual comment char.的注释autoflow.coffee即它并非按语言的真实注释语法判断换行点只能落在词间空白处超宽单词整词成行段落内若混用不同前缀如首行//中间某行#只有首行前缀会被剥离和重复这是该算法的设计取舍重排是写缓冲区的硬换行操作与视图层的软换行softWrap/softWrapAtPreferredLineLength是两套机制互不替代。小结Autoflow 虽然只是 Atom 内置包中最小的一批之一但它的实现链路非常完整键位与菜单把autoflow:reflow-selection命令接到TextEditor模型reflowSelection 用选区或 段落范围 划定范围reflow 纯函数按“归一化换行 → 保护首尾空白 → 空行切段 → 识别 LaTeX 标签与注释前缀 → 按词分段换行 → 拼回前缀标签”六步完成重排行宽与 Tab 宽度均来自带作用域的配置项editor.preferredLineLength和editor.tabLength。spec 目录下的测试 对每个阶段都有独立断言是阅读这个重排算法时最可靠的参照。【免费下载链接】atom:atom: The hackable text editor项目地址: https://gitcode.com/gh_mirrors/at/atom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
