RuboCop v0.37.0 版本深度解析三大新 cop、默认行为变更与 30 项缺陷修复【免费下载链接】rubocopA Ruby static code analyzer and formatter, based on the community Ruby style guide.项目地址: https://gitcode.com/GitHub_Trending/rub/rubocop本指南基于仓库内的 v0.37.0 版本发布说明系统解读 RuboCop 0.37.0 带来的 7 项新功能、30 项缺陷修复与 4 项行为变更并结合当前仓库源码lib/rubocop/cop/与config/default.yml逐项剖析底层实现。读完本文你将理解Style/ZeroLengthPredicate、Style/SpaceAroundKeyword、Multiline*BraceLayout系列 cop 的检查规则与自动修正原理掌握Style/SignalException默认风格调整等破坏性变更的迁移要点。适用前提v0.37.0 是 RuboCop 的历史版本发布于 2016 年前后当前仓库主版本已演进至 1.91.0见 CHANGELOG.md。文中所涉 cop 大多延续至今但其配置与实现可能经后续版本修订实际运行时的默认值应以当前仓库的 config/default.yml 为准。一、版本概览一次面向代码风格与布局的集中升级v0.37.0 的发布说明包含三个板块New features7 项新增 4 个新 copStyle/ZeroLengthPredicate、Style/SpaceAroundKeyword、Style/MultilineHashBraceLayout、Style/MultilineMethodDefinitionBraceLayout、Style/MultilineMethodCallBraceLayout其中 Multiline 系列为 3 个增强Performance/Casecmp的检测范围并为 HTML 输出增加浮动表头Bug fixes30 项覆盖 Style、Lint、Performance、Layout 等部门的崩溃修复、误报修复与自动修正正确性修复Changes4 项删除两个被替代的旧 cop、调整两个 cop 的默认/判定行为。主要贡献者包括 drenmi、lumeet、panthomakos、segiddins、rrosenblum、jonas054、bbatsov 等人完整名单见 relnotes/v0.37.0.md 文末的贡献者索引。其中 panthomakos 一次性贡献了三个 Multiline 花括号布局 copsegiddins 集中修复了Style/MutableConstant、Style/ConditionalAssignment等常量相关 cop是本次版本迭代的两大主线。二、新 copStyle/ZeroLengthPredicate——用 empty? 取代长度比较该 cop 检查形如object.size 0、object.length 0、object.length ! 0、object.length 1等数值比较并建议替换为语义更清晰的empty?/!empty?谓词方法。这是本次版本最典型的一个代码质量型 cop。2.1 检测模式与源码实现在 zero_length_predicate.rb 中cop 通过RESTRICT_ON_SEND %i[size length]限定只关注size与length两个消息并在on_send/on_csend中依次执行三类检查check_zero_length_predicate捕获receiver.length.zero?、receiver.size.zero?这类二次调用对应def_node_matcher :zero_length_predicate?的(call (call (...) {:length :size}) :zero?)模式check_zero_length_comparison捕获length 0、0 length、length 1、1 lengthcheck_nonzero_length_comparison捕获length 0、length ! 0、0 length、0 ! length。自动修正由replacement方法完成若length/size调用带有接收者则直接替换为receiver.empty?否则为另一侧的接收者加上!前缀生成!receiver.empty?。例如# bad [1, 2, 3].length 0 0 foobar.length array.length 1 {a: 1, b: 2}.length ! 0 string.length 0 hash.size 0 str.size.zero? # good自动修正后 [1, 2, 3].empty? foobar.empty? array.empty? !{a: 1, b: 2}.empty? !string.empty? !hash.empty? str.empty?2.2 例外集合与安全性标记源码中的non_polymorphic_collection?模式专门排除了File、Tempfile、StringIO、File::Stat及其new/open产生的对象——这些标准库类型实现了size却没有empty?若不排除会产生误报。注释同时指出当File::Stat对象被存入变量如stat File.stat(path); stat.size.zero?时cop 无法推断类型仍可能误报。在 config/default.yml 中该 cop 的配置为Enabled: true且Safe: false其后的VersionChanged: 0.39表明 0.39 版本还有后续修订。Safe: false意味着它被归类为不安全 cop因为无法保证接收者实现的empty?确实以length为定义基础若存在重定义length或empty?的非标准类可能产生误报。因此运行自动修正时需谨慎必要时先通过代码评审确认。三、新 copStyle/SpaceAroundKeyword——关键字两侧空格统一检查Style/SpaceAroundKeyword用于统一检查各类 Ruby 关键字前后的空格缺失例如块关键字do/end、条件关键字if/else/unless、循环关键字while/until、以及return、break、next、rescue、yield、defined?、super等。3.1 源码实现要点在 space_around_keyword.rb 中cop 为每种相关 AST 节点注册了回调on_if、on_block、on_while、on_return、on_rescue等统一委托给check方法按:begin/:end/:keyword三种位置分别校验并借助AutoCorrector在缺失处插入空格# bad something testdo|x| end while(something) end something 123if test return(foo bar) # good自动修正后 something test do |x| end while (something) end something 123 if test return (foo bar)实现中的几个细节值得注意白名单机制ACCEPT_LEFT_PAREN %w[break defined? next not rescue super yield]允许这些关键字后紧跟左括号如yield(foo)合法ACCEPT_LEFT_SQUARE_BRACKET允许super[0]这类写法SAFE_NAVIGATION与NAMESPACE_OPERATOR常量则处理super.foo、super::Bar的场景运算符上下文豁免preceded_by_operator?会向上遍历 AST当关键字处于and/or等运算符关键字表达式之后时不要求其前方空格兼容现代语法文件还注册了on_numblock、on_itblock、on_case_match、on_in_pattern等回调说明该 cop 在后续版本中持续演进以覆盖数字块参数、case/in模式匹配等新语法。3.2 命名空间说明发布说明中以Style/SpaceAroundKeyword命名而当前仓库中该 cop 位于 Layout 部门即Layout/SpaceAroundKeyword见 config/default.yml。读者在配置.rubocop.yml时应以当前命名空间为准。四、Multiline*BraceLayout 系列多行字面量的花括号对称性本次版本由 panthomakos 一次性引入三个花括号布局 cop分别针对哈希字面量、方法定义与方法调用核心规则是多行结构的闭合花括号应与开头花括号保持对称。4.1 三种 EnforcedStyle三个 cop 均支持symmetrical默认、new_line、same_line三种风格配置完全一致。以哈希为例multiline_hash_brace_layout.rbsymmetrical默认开头花括号与首元素同行则闭合花括号必须与末元素同行开头花括号独立成行则闭合花括号也必须独立成行new_line闭合花括号必须始终位于末元素之后的新行same_line闭合花括号必须始终与末元素同行。# EnforcedStyle: symmetrical默认 # bad { a: 1, b: 2 } # bad { a: 1, b: 2 } # good { a: 1, b: 2 } # good { a: 1, b: 2 }方法定义与方法调用的规则完全同构分别将元素替换为参数/实参见 multiline_method_definition_brace_layout.rb 与 multiline_method_call_brace_layout.rb# 方法定义symmetrical # bad def foo(a, b ) end # good def foo(a, b) end # 方法调用symmetrical # bad foo(a, b ) # good foo( a, b )4.2 共用 mixin 的底层逻辑三个 cop 都include MultilineLiteralBraceLayoutmixin/multiline_literal_brace_layout.rb其核心方法check_symmetrical的逻辑是若开头花括号与首元素同行opening_brace_on_same_line?则要求闭合花括号也与末元素同行否则报告SAME_LINE_MESSAGE反之则要求闭合花括号换行否则报告NEW_LINE_MESSAGE。check_new_line/check_same_line则分别强制两种固定风格。mixin 还内置了两类防御性处理隐式/空/单行字面量豁免ignored_literal?跳过无显式花括号如foo a: 1、空字面量以及本就单行的结构Heredoc 冲突检测last_line_heredoc?递归检查末元素及其子节点是否包含跨越父节点末行的 heredoc——若调整花括号会导致 heredoc 语法失效则放弃报告避免产生非法代码。在 config/default.yml 中三个 cop 均默认Enabled: true、EnforcedStyle: symmetricalSupportedStyles依次列出symmetrical、new_line、same_line可直接在.rubocop.yml中按团队约定覆盖。五、Performance/Casecmp 增强覆盖 downcase/upcase 与 !Performance/Casecmp在 v0.37.0 中获得了三轮增强PR #2699、issue #2614、PR #2664当str.downcase或str.upcase的结果被传入等式比较如str.downcase other时现在也能登记违规提示改用casecmp检查casecmp返回值为 0 的比较模式如a.casecmp(b) 0自动修正现在可以安全地处理对变量与方法调用的 case 比较配套的行为变更中还支持了!比较的检测a.casecmp(b) ! 0这类写法。这使Performance/Casecmp从仅检测直接调用扩展到检测常见的大小写折叠比较惯用法覆盖更完整的性能优化场景。六、HTML 输出滚动时表头保持可见v0.37.0 为 HTML 格式化输出引入了浮动表头Floating headers当报告中包含大量文件/违规记录、页面纵向滚动时表头行固定在可视区域内方便持续对照列含义。HTML 格式的模板位于仓库的 assets/output.html.erb由HtmlFormatter在 formatter/html_formatter.rb 中渲染对应测试见 html_formatter_spec.rb。七、Bug 修复全览30 项缺陷修复按领域分组v0.37.0 修复了 30 项缺陷其中大量集中于自动修正正确性与崩溃防护。以下按领域分组整理条目与 relnotes/v0.37.0.md 一一对应7.1 Style 部门Issue/PR修复内容#2723修复Style/GuardClause抛出的NoMethodError#2630Style/MutableConstant将 frozen string literal 纳入考量启用该魔法注释的文件中的字符串常量不再误报#2642Style/MutableConstant支持通过\|\|对常量赋值#2646修复Style/ConditionalAssignment对常量赋值进行自动修正时的错误#2654修复Style/RedundantParentheses对一元操作的处理#2729修复Style/RedundantParentheses对首个参数为哈希字面量的处理#2721Style/RedundantParentheses不再对传入rescue的括号包裹常量登记违规#2661Style/Next自动修正修饰符if/unless时不再崩溃#2696Style/NestedModifier在必要时为条件自动加上括号#2690修复Style/MultilineOperationIndentation中属于赋值一部分的操作数对齐#2742修复Style/TrailingCommaInArguments与Style/TrailingCommaInLiteral对内联单元素数组的处理#2768Style/MethodCallParentheses允许关键字not之后使用括号—当freeze被调用在 frozen string literal 上时Style/RedundantFreeze现在会报告违规#2758camel case 变量名允许前导下划线7.2 Lint 部门Issue/PR修复内容#2647Lint/LiteralInInterpolation允许xstr反引号命令插值出现在插值中#2666修复Lint/LiteralInInterpolation对符号字面量进行自动修正时的 bug—Lint/DuplicateMethods在使用隐式接收者的class_eval时不再崩溃#2707Lint/NestedMethodDefinition尊重Class.new与Module.new中的方法定义#2703Lint/EndAlignment与Lint/DefEndAlignment处理字节序标记BOM7.3 Performance 部门Issue/PR修复内容#2674Performance/RedundantMerge同时检查Hash#update别名#2614Performance/Casecmp检查casecmp的零返回值比较#2664Performance/Casecmp可无错误地自动修正针对变量与方法调用的 case 比较#2641修复Performance/RedundantBlockCall对带块参数的空方法的崩溃#2689Performance/RedundantBlockCall尊重括号使用情况#2691Performance/TimesMap不再对名为times的变量调用map/collect登记违规7.4 Layout 与其他基础设施Issue/PR修复内容#2703Style/IndentationWidth与Style/ElseAlignment处理字节序标记BOM#2710部分 cop 修复全角字符的处理#2665修复测试在 Windows 平台上的通过性#2694修复使用不同 JSON gem如 Oj时的缓存问题#2701若后续赋值位于循环内则不再将相同变量的赋值视为无用赋值#2228无论相关 cop 是否启用都使用其配置其中 #2228 值得特别说明此前当一个 cop 被禁用时与其相关的另一 cop 读取配置可能拿到错误默认值导致行为不一致本次修复后配置解析不再受被检查 cop 启用状态影响这是对配置加载机制相关实现见 config.rb的一次语义修正。八、行为变更默认值与旧 cop 的落幕8.1 移除 Style/SpaceAfterControlKeyword 与 Style/SpaceBeforeModifierKeyword由于新的Style/SpaceAroundKeyword覆盖面更广v0.37.0 直接移除了两个旧 copStyle/SpaceAfterControlKeyword控制关键字后空格与Style/SpaceBeforeModifierKeyword修饰符关键字前空格。在当前仓库的lib/rubocop/cop/中已检索不到这两个文件确认其已彻底移除。升级到 0.37.0 后若.rubocop.yml中仍配置这两个 cop需要将其删除或替换为Style/SpaceAroundKeyword。8.2 Style/SignalException 默认风格改为 only_raiseStyle/SignalExceptionsignal_exception.rb用于规范fail与raise的使用支持only_raise、only_fail、semantic三种风格。v0.37.0 将其默认风格从先前的取值改为only_raise即默认强制使用raiseRuby 社区长期约定fail仅在异常不可恢复时语义化使用。在 config/default.yml 中可看到EnforcedStyle: only_raise与VersionChanged: 0.37相互印证其后的Preview: Enabled: false说明在后续版本中该 cop 默认启用的策略又有演进当前仓库以最新配置为准。# EnforcedStyle: only_raisev0.37.0 起默认 # bad fail Kernel.fail # good raise Kernel.raise8.3 Style/FrozenStringLiteralComment 不再依赖运行中的 Ruby 版本Style/FrozenStringLiteralComment负责检查/添加# frozen_string_literal: true魔法注释frozen_string_literal_comment.rb核心逻辑在on_new_investigation中完成。v0.37.0 之前该 cop 的判定会参考运行 RuboCop 的 Ruby 版本本次变更为不再基于正在运行的 Ruby 版本做决策而是以目标 Ruby 版本TargetRubyVersion为准避免同一份配置在不同 Ruby 环境下产生不同结果提升跨环境一致性。九、总结与升级建议v0.37.0 的核心价值可以概括为三点布局体系补全Multiline*BraceLayout三兄弟 Style/SpaceAroundKeyword填补了多行结构与关键字空格领域的空白并通过共享 mixin 保证了三类花括号布局行为的高度一致语义化改进Style/ZeroLengthPredicate引导开发者用empty?替代脆弱的长度比较Style/SignalException默认风格转向only_raise稳健性提升30 项修复覆盖崩溃防护、误报消除与自动修正正确性尤其围绕常量处理、casecmp与各类括号/逗号布局边界场景。对于从旧版本升级的用户建议按以下顺序检查迁移面移除.rubocop.yml中的Style/SpaceAfterControlKeyword与Style/SpaceBeforeModifierKeyword配置确认Style/SignalException新默认风格only_raise是否符合团队约定不符合则在配置中显式指定EnforcedStyle: semantic或only_fail若团队对empty?语义有自定义实现审慎启用Style/ZeroLengthPredicateSafe: false。更多 cop 的完整配置与默认值可查阅 config/default.yml各 cop 的详细文档与示例见 docs/cops_style.adoc、docs/cops_layout.adoc 与 docs/cops_performance.adoc修复清单全文见 relnotes/v0.37.0.md。【免费下载链接】rubocopA Ruby static code analyzer and formatter, based on the community Ruby style guide.项目地址: https://gitcode.com/GitHub_Trending/rub/rubocop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RuboCop v0.37.0 版本深度解析：三大新 cop、默认行为变更与 30 项缺陷修复
RuboCop v0.37.0 版本深度解析三大新 cop、默认行为变更与 30 项缺陷修复【免费下载链接】rubocopA Ruby static code analyzer and formatter, based on the community Ruby style guide.项目地址: https://gitcode.com/GitHub_Trending/rub/rubocop本指南基于仓库内的 v0.37.0 版本发布说明系统解读 RuboCop 0.37.0 带来的 7 项新功能、30 项缺陷修复与 4 项行为变更并结合当前仓库源码lib/rubocop/cop/与config/default.yml逐项剖析底层实现。读完本文你将理解Style/ZeroLengthPredicate、Style/SpaceAroundKeyword、Multiline*BraceLayout系列 cop 的检查规则与自动修正原理掌握Style/SignalException默认风格调整等破坏性变更的迁移要点。适用前提v0.37.0 是 RuboCop 的历史版本发布于 2016 年前后当前仓库主版本已演进至 1.91.0见 CHANGELOG.md。文中所涉 cop 大多延续至今但其配置与实现可能经后续版本修订实际运行时的默认值应以当前仓库的 config/default.yml 为准。一、版本概览一次面向代码风格与布局的集中升级v0.37.0 的发布说明包含三个板块New features7 项新增 4 个新 copStyle/ZeroLengthPredicate、Style/SpaceAroundKeyword、Style/MultilineHashBraceLayout、Style/MultilineMethodDefinitionBraceLayout、Style/MultilineMethodCallBraceLayout其中 Multiline 系列为 3 个增强Performance/Casecmp的检测范围并为 HTML 输出增加浮动表头Bug fixes30 项覆盖 Style、Lint、Performance、Layout 等部门的崩溃修复、误报修复与自动修正正确性修复Changes4 项删除两个被替代的旧 cop、调整两个 cop 的默认/判定行为。主要贡献者包括 drenmi、lumeet、panthomakos、segiddins、rrosenblum、jonas054、bbatsov 等人完整名单见 relnotes/v0.37.0.md 文末的贡献者索引。其中 panthomakos 一次性贡献了三个 Multiline 花括号布局 copsegiddins 集中修复了Style/MutableConstant、Style/ConditionalAssignment等常量相关 cop是本次版本迭代的两大主线。二、新 copStyle/ZeroLengthPredicate——用 empty? 取代长度比较该 cop 检查形如object.size 0、object.length 0、object.length ! 0、object.length 1等数值比较并建议替换为语义更清晰的empty?/!empty?谓词方法。这是本次版本最典型的一个代码质量型 cop。2.1 检测模式与源码实现在 zero_length_predicate.rb 中cop 通过RESTRICT_ON_SEND %i[size length]限定只关注size与length两个消息并在on_send/on_csend中依次执行三类检查check_zero_length_predicate捕获receiver.length.zero?、receiver.size.zero?这类二次调用对应def_node_matcher :zero_length_predicate?的(call (call (...) {:length :size}) :zero?)模式check_zero_length_comparison捕获length 0、0 length、length 1、1 lengthcheck_nonzero_length_comparison捕获length 0、length ! 0、0 length、0 ! length。自动修正由replacement方法完成若length/size调用带有接收者则直接替换为receiver.empty?否则为另一侧的接收者加上!前缀生成!receiver.empty?。例如# bad [1, 2, 3].length 0 0 foobar.length array.length 1 {a: 1, b: 2}.length ! 0 string.length 0 hash.size 0 str.size.zero? # good自动修正后 [1, 2, 3].empty? foobar.empty? array.empty? !{a: 1, b: 2}.empty? !string.empty? !hash.empty? str.empty?2.2 例外集合与安全性标记源码中的non_polymorphic_collection?模式专门排除了File、Tempfile、StringIO、File::Stat及其new/open产生的对象——这些标准库类型实现了size却没有empty?若不排除会产生误报。注释同时指出当File::Stat对象被存入变量如stat File.stat(path); stat.size.zero?时cop 无法推断类型仍可能误报。在 config/default.yml 中该 cop 的配置为Enabled: true且Safe: false其后的VersionChanged: 0.39表明 0.39 版本还有后续修订。Safe: false意味着它被归类为不安全 cop因为无法保证接收者实现的empty?确实以length为定义基础若存在重定义length或empty?的非标准类可能产生误报。因此运行自动修正时需谨慎必要时先通过代码评审确认。三、新 copStyle/SpaceAroundKeyword——关键字两侧空格统一检查Style/SpaceAroundKeyword用于统一检查各类 Ruby 关键字前后的空格缺失例如块关键字do/end、条件关键字if/else/unless、循环关键字while/until、以及return、break、next、rescue、yield、defined?、super等。3.1 源码实现要点在 space_around_keyword.rb 中cop 为每种相关 AST 节点注册了回调on_if、on_block、on_while、on_return、on_rescue等统一委托给check方法按:begin/:end/:keyword三种位置分别校验并借助AutoCorrector在缺失处插入空格# bad something testdo|x| end while(something) end something 123if test return(foo bar) # good自动修正后 something test do |x| end while (something) end something 123 if test return (foo bar)实现中的几个细节值得注意白名单机制ACCEPT_LEFT_PAREN %w[break defined? next not rescue super yield]允许这些关键字后紧跟左括号如yield(foo)合法ACCEPT_LEFT_SQUARE_BRACKET允许super[0]这类写法SAFE_NAVIGATION与NAMESPACE_OPERATOR常量则处理super.foo、super::Bar的场景运算符上下文豁免preceded_by_operator?会向上遍历 AST当关键字处于and/or等运算符关键字表达式之后时不要求其前方空格兼容现代语法文件还注册了on_numblock、on_itblock、on_case_match、on_in_pattern等回调说明该 cop 在后续版本中持续演进以覆盖数字块参数、case/in模式匹配等新语法。3.2 命名空间说明发布说明中以Style/SpaceAroundKeyword命名而当前仓库中该 cop 位于 Layout 部门即Layout/SpaceAroundKeyword见 config/default.yml。读者在配置.rubocop.yml时应以当前命名空间为准。四、Multiline*BraceLayout 系列多行字面量的花括号对称性本次版本由 panthomakos 一次性引入三个花括号布局 cop分别针对哈希字面量、方法定义与方法调用核心规则是多行结构的闭合花括号应与开头花括号保持对称。4.1 三种 EnforcedStyle三个 cop 均支持symmetrical默认、new_line、same_line三种风格配置完全一致。以哈希为例multiline_hash_brace_layout.rbsymmetrical默认开头花括号与首元素同行则闭合花括号必须与末元素同行开头花括号独立成行则闭合花括号也必须独立成行new_line闭合花括号必须始终位于末元素之后的新行same_line闭合花括号必须始终与末元素同行。# EnforcedStyle: symmetrical默认 # bad { a: 1, b: 2 } # bad { a: 1, b: 2 } # good { a: 1, b: 2 } # good { a: 1, b: 2 }方法定义与方法调用的规则完全同构分别将元素替换为参数/实参见 multiline_method_definition_brace_layout.rb 与 multiline_method_call_brace_layout.rb# 方法定义symmetrical # bad def foo(a, b ) end # good def foo(a, b) end # 方法调用symmetrical # bad foo(a, b ) # good foo( a, b )4.2 共用 mixin 的底层逻辑三个 cop 都include MultilineLiteralBraceLayoutmixin/multiline_literal_brace_layout.rb其核心方法check_symmetrical的逻辑是若开头花括号与首元素同行opening_brace_on_same_line?则要求闭合花括号也与末元素同行否则报告SAME_LINE_MESSAGE反之则要求闭合花括号换行否则报告NEW_LINE_MESSAGE。check_new_line/check_same_line则分别强制两种固定风格。mixin 还内置了两类防御性处理隐式/空/单行字面量豁免ignored_literal?跳过无显式花括号如foo a: 1、空字面量以及本就单行的结构Heredoc 冲突检测last_line_heredoc?递归检查末元素及其子节点是否包含跨越父节点末行的 heredoc——若调整花括号会导致 heredoc 语法失效则放弃报告避免产生非法代码。在 config/default.yml 中三个 cop 均默认Enabled: true、EnforcedStyle: symmetricalSupportedStyles依次列出symmetrical、new_line、same_line可直接在.rubocop.yml中按团队约定覆盖。五、Performance/Casecmp 增强覆盖 downcase/upcase 与 !Performance/Casecmp在 v0.37.0 中获得了三轮增强PR #2699、issue #2614、PR #2664当str.downcase或str.upcase的结果被传入等式比较如str.downcase other时现在也能登记违规提示改用casecmp检查casecmp返回值为 0 的比较模式如a.casecmp(b) 0自动修正现在可以安全地处理对变量与方法调用的 case 比较配套的行为变更中还支持了!比较的检测a.casecmp(b) ! 0这类写法。这使Performance/Casecmp从仅检测直接调用扩展到检测常见的大小写折叠比较惯用法覆盖更完整的性能优化场景。六、HTML 输出滚动时表头保持可见v0.37.0 为 HTML 格式化输出引入了浮动表头Floating headers当报告中包含大量文件/违规记录、页面纵向滚动时表头行固定在可视区域内方便持续对照列含义。HTML 格式的模板位于仓库的 assets/output.html.erb由HtmlFormatter在 formatter/html_formatter.rb 中渲染对应测试见 html_formatter_spec.rb。七、Bug 修复全览30 项缺陷修复按领域分组v0.37.0 修复了 30 项缺陷其中大量集中于自动修正正确性与崩溃防护。以下按领域分组整理条目与 relnotes/v0.37.0.md 一一对应7.1 Style 部门Issue/PR修复内容#2723修复Style/GuardClause抛出的NoMethodError#2630Style/MutableConstant将 frozen string literal 纳入考量启用该魔法注释的文件中的字符串常量不再误报#2642Style/MutableConstant支持通过\|\|对常量赋值#2646修复Style/ConditionalAssignment对常量赋值进行自动修正时的错误#2654修复Style/RedundantParentheses对一元操作的处理#2729修复Style/RedundantParentheses对首个参数为哈希字面量的处理#2721Style/RedundantParentheses不再对传入rescue的括号包裹常量登记违规#2661Style/Next自动修正修饰符if/unless时不再崩溃#2696Style/NestedModifier在必要时为条件自动加上括号#2690修复Style/MultilineOperationIndentation中属于赋值一部分的操作数对齐#2742修复Style/TrailingCommaInArguments与Style/TrailingCommaInLiteral对内联单元素数组的处理#2768Style/MethodCallParentheses允许关键字not之后使用括号—当freeze被调用在 frozen string literal 上时Style/RedundantFreeze现在会报告违规#2758camel case 变量名允许前导下划线7.2 Lint 部门Issue/PR修复内容#2647Lint/LiteralInInterpolation允许xstr反引号命令插值出现在插值中#2666修复Lint/LiteralInInterpolation对符号字面量进行自动修正时的 bug—Lint/DuplicateMethods在使用隐式接收者的class_eval时不再崩溃#2707Lint/NestedMethodDefinition尊重Class.new与Module.new中的方法定义#2703Lint/EndAlignment与Lint/DefEndAlignment处理字节序标记BOM7.3 Performance 部门Issue/PR修复内容#2674Performance/RedundantMerge同时检查Hash#update别名#2614Performance/Casecmp检查casecmp的零返回值比较#2664Performance/Casecmp可无错误地自动修正针对变量与方法调用的 case 比较#2641修复Performance/RedundantBlockCall对带块参数的空方法的崩溃#2689Performance/RedundantBlockCall尊重括号使用情况#2691Performance/TimesMap不再对名为times的变量调用map/collect登记违规7.4 Layout 与其他基础设施Issue/PR修复内容#2703Style/IndentationWidth与Style/ElseAlignment处理字节序标记BOM#2710部分 cop 修复全角字符的处理#2665修复测试在 Windows 平台上的通过性#2694修复使用不同 JSON gem如 Oj时的缓存问题#2701若后续赋值位于循环内则不再将相同变量的赋值视为无用赋值#2228无论相关 cop 是否启用都使用其配置其中 #2228 值得特别说明此前当一个 cop 被禁用时与其相关的另一 cop 读取配置可能拿到错误默认值导致行为不一致本次修复后配置解析不再受被检查 cop 启用状态影响这是对配置加载机制相关实现见 config.rb的一次语义修正。八、行为变更默认值与旧 cop 的落幕8.1 移除 Style/SpaceAfterControlKeyword 与 Style/SpaceBeforeModifierKeyword由于新的Style/SpaceAroundKeyword覆盖面更广v0.37.0 直接移除了两个旧 copStyle/SpaceAfterControlKeyword控制关键字后空格与Style/SpaceBeforeModifierKeyword修饰符关键字前空格。在当前仓库的lib/rubocop/cop/中已检索不到这两个文件确认其已彻底移除。升级到 0.37.0 后若.rubocop.yml中仍配置这两个 cop需要将其删除或替换为Style/SpaceAroundKeyword。8.2 Style/SignalException 默认风格改为 only_raiseStyle/SignalExceptionsignal_exception.rb用于规范fail与raise的使用支持only_raise、only_fail、semantic三种风格。v0.37.0 将其默认风格从先前的取值改为only_raise即默认强制使用raiseRuby 社区长期约定fail仅在异常不可恢复时语义化使用。在 config/default.yml 中可看到EnforcedStyle: only_raise与VersionChanged: 0.37相互印证其后的Preview: Enabled: false说明在后续版本中该 cop 默认启用的策略又有演进当前仓库以最新配置为准。# EnforcedStyle: only_raisev0.37.0 起默认 # bad fail Kernel.fail # good raise Kernel.raise8.3 Style/FrozenStringLiteralComment 不再依赖运行中的 Ruby 版本Style/FrozenStringLiteralComment负责检查/添加# frozen_string_literal: true魔法注释frozen_string_literal_comment.rb核心逻辑在on_new_investigation中完成。v0.37.0 之前该 cop 的判定会参考运行 RuboCop 的 Ruby 版本本次变更为不再基于正在运行的 Ruby 版本做决策而是以目标 Ruby 版本TargetRubyVersion为准避免同一份配置在不同 Ruby 环境下产生不同结果提升跨环境一致性。九、总结与升级建议v0.37.0 的核心价值可以概括为三点布局体系补全Multiline*BraceLayout三兄弟 Style/SpaceAroundKeyword填补了多行结构与关键字空格领域的空白并通过共享 mixin 保证了三类花括号布局行为的高度一致语义化改进Style/ZeroLengthPredicate引导开发者用empty?替代脆弱的长度比较Style/SignalException默认风格转向only_raise稳健性提升30 项修复覆盖崩溃防护、误报消除与自动修正正确性尤其围绕常量处理、casecmp与各类括号/逗号布局边界场景。对于从旧版本升级的用户建议按以下顺序检查迁移面移除.rubocop.yml中的Style/SpaceAfterControlKeyword与Style/SpaceBeforeModifierKeyword配置确认Style/SignalException新默认风格only_raise是否符合团队约定不符合则在配置中显式指定EnforcedStyle: semantic或only_fail若团队对empty?语义有自定义实现审慎启用Style/ZeroLengthPredicateSafe: false。更多 cop 的完整配置与默认值可查阅 config/default.yml各 cop 的详细文档与示例见 docs/cops_style.adoc、docs/cops_layout.adoc 与 docs/cops_performance.adoc修复清单全文见 relnotes/v0.37.0.md。【免费下载链接】rubocopA Ruby static code analyzer and formatter, based on the community Ruby style guide.项目地址: https://gitcode.com/GitHub_Trending/rub/rubocop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考