Ruby 2+环境下替代rails-erd的Rails Active Record可视化工具推荐

Hey there! 针对你接手Rails项目后需要快速梳理数据结构，却遇到rails-erd旧版兼容问题、railroady达不到预期的情况，我整理了几个在Ruby 2+环境下稳定好用的替代方案：

1. 优先更新 rails-erd 至最新版 #

其实官方早已更新了rails-erd，现在它完全支持Ruby 2.x及更高版本（包括Ruby 3+），之前的兼容问题大概率是因为你用的是旧版本。试试这个步骤：

• 在Gemfile的development组中添加：

  gem 'rails-erd', require: false
  

• 执行bundle install完成安装
• 运行生成命令：

  bundle exec erd
  

  它会自动扫描你的Active Record模型，支持导出PDF、SVG、DOT等多种格式，还能通过参数（比如--only指定模型、--exclude忽略模型）自定义生成范围，非常适合快速摸清项目的表关联关系。

2. ArDiagram 轻量直观的现代ER图工具 #

这个gem专门为Ruby 2+和现代Rails版本设计，生成的ER图简洁清晰，配置灵活：

• 安装：在Gemfile中添加并执行bundle：

  gem 'ar_diagram', group: :development
  

• 生成ER图：

  bundle exec ar_diagram generate
  

• 额外配置：你可以在项目根目录创建config/ar_diagram.yml，自定义要显示的模型、关联样式，或者指定导出格式（PNG/SVG），比如忽略Devise自动生成的模型，只展示业务相关的表。

3. 使用 Rails 自带 Schema + Graphviz 手动生成 #

如果不想额外安装gem，也可以用Rails自带的schema文件配合Graphviz生成：

• 先确保本地安装了Graphviz（Mac用brew install graphviz，Ubuntu用sudo apt-get install graphviz，Windows需下载安装包）
• 导出schema为DOT格式：

  rails db:schema:dump --format=dot
  

• 转成可视化图：

  dot -Tpng db/schema.dot -o erd.png
  

  这个方法无需额外gem，适合临时快速查看数据结构。

注意事项 #

所有ER图生成工具几乎都依赖Graphviz，所以先确认你的环境已经安装了这个工具，否则会出现生成失败的情况。

内容的提问来源于stack exchange，提问作者Dr.Gonzo