Z
ZHANK
进阶技巧

Ruby 最佳实践

RuboCop 代码检查、风格指南、SOLID 原则、Rails 约定

Ruby 最佳实践

RuboCop 是 Ruby 社区的标准代码检查工具。风格指南和 SOLID 原则让代码可维护。

学完本章你将: 掌握 RuboCop、风格指南、SOLID、Rails 约定。


RuboCop

bash
gem install rubocop
rubocop                    # 检查所有文件
rubocop --auto-correct     # 自动修复
rubocop --only Layout      # 只检查布局

风格要点

ruby
# ✅ 缩进 2 空格(不是 Tab)
# ✅ 方法名 snake_case
# ✅ 类/模块名 CamelCase
# ✅ 常量 UPPER_SNAKE_CASE
# ✅ 布尔方法以 ? 结尾
# ✅ 危险方法以 ! 结尾

# ✅ 用 each/map 而不是 for
# ✅ 用 Symbol 做 Hash 键
# ✅ 优先用 do...end 多行块,{ } 单行块

SOLID 在 Ruby 中

ruby
# 单一职责
class UserRepository
    def find(id); end
end

# 依赖注入
class UserService
    def initialize(repository)
        @repository = repository
    end
end

# 开闭原则——用 Module prepend 扩展而非修改
module Logging
    def save
        log "保存前"
        super
        log "保存后"
    end
end