title: 若依代码生成器源码与模板扩展 tags:

module
ruoyi
codegen
template
joplin type: module source_type: reconstructed created: 2026-04-23 updated: 2026-04-23 ---

若依代码生成器源码与模板扩展

[!abstract] 这一模块对应若依的“拔高原理篇”，重点是生成器底层表、源码流程和模板机制，从而具备二次定制能力。

模块结论

若依生成器并不是黑盒，它依赖明确的元数据表和模板渲染流程。
真正能做框架定制的人，必须理解生成器源码链路，而不只是会点击“生成代码”。
[[Velocity模板引擎]] 是生成器输出代码的重要一环。

一、生成器源码为什么值得学

你会知道生成代码不是魔法，而是“表配置 + 模板渲染 + 文件输出”
你才能修改默认模板
你才能让生成器适配团队自己的代码规范

二、应重点关注哪些内容

生成器配置表
字段配置表
导入表结构流程
生成请求入口
模板渲染位置
输出文件分类

三、模板扩展在解决什么问题

默认模板不满足团队规范
需要增加注解、父类、字段规则或文档信息
需要让生成代码与项目架构更一致

四、为什么 Velocity 是关键

它把“静态模板”与“动态元数据”结合
代码生成器的本质输出就建立在这个渲染过程上
因此懂模板变量和输出结构，才能真正扩展生成器

五、易错点

只改生成后的代码，不改模板，导致重复劳动。
只会看控制层入口，不去追踪配置表和模板变量。
把模板扩展理解成前端页面小修小补，而不是框架级输出定制。

六、复习提问

若依生成器为什么能根据表结构输出一整套代码？
模板扩展和手改生成结果相比，哪个更适合长期维护？
Velocity 在整条生成链路里的角色是什么？

来源

[[raw/Joplin/软件、框架学习记录/若依框架/3.拔高原理篇.md]]
[[raw/Joplin/软件、框架学习记录/若依框架/4.附加修改后模板.md]]

相关页面

[[若依框架]]
[[若依代码生成器]]
[[Velocity模板引擎]]