---
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模板引擎]]