误区 1：把 Rails 当脚手架生成器，而不是框架体系。
只会 generate scaffold，却不理解路由、控制器、模型、迁移、视图的配合，后面很快会迷路。
误区 2：把 Controller 写成总调度黑洞。
窗口负责协调，不该自己兼任档案员、邮政员、运输队长和报表室。
误区 3：以为 ORM 让你不用懂数据库。
Rails 帮你更高层地操作数据，但索引、事务、N+1、锁、预加载、批量操作，照样要懂。
误区 4：滥用回调。after_save、after_commit 很方便，但如果所有跨系统副作用都藏在回调里，项目会越来越难追踪。关键副作用要么清晰写出来，要么明确进入后台任务。
误区 5：一切都强塞资源式路由。
Rails 默认偏资源式没错，但不是所有动作都必须伪装成 CRUD。适合资源就资源，不适合就显式路由。
误区 6：一上来就把前端彻底 SPA 化。
很多业务后台、管理台、表单系统，本来 Hotwire 就够了。你先确认工地规模，再决定要不要请重型前端总包。
误区 7：看旧教程却以为那就是今天的主线。
到 2026 年，官方主线里你应该知道 Propshaft、Hotwire、Active Job 默认 Solid Queue、官方 authentication generator 这些变化。别把 2018 年和 2026 年的 Rails 混成一锅。
误区 8：把“Rails magic”当黑箱。
只要你把命名、目录、默认查找规则搞清楚，所谓魔法基本都会变成可解释机制。