模板代码生成
用占位符模板为可重复结构生成代码。
代码生成入门
为什么
GitHub 2024 Octoverse 报告显示生成式 AI 项目贡献量激增 59%，平台 AI 项目总数增长 98%。模板（带占位符）使可重复结构 — 配置文件、映射器、适配器 — 一致且 schema 变更时快速重新生成。
AI 正确填占位符，而手填易错。
何时使用
当有 3+ 结构相同仅名/值不同的文件时用。唯一文件跳过。
如何做
1. 识别共享结构（带占位符模板）。
2. 列每实例值（名、类型、路径）。
3. 提示："为每行实例化模板；保持结构相同"。
4. 审查占位符遗漏（未填 {{x}}）。
5. 模板或值变更时重新生成。
示例
模板：src/api/{{resource}}.ts 含 {{Resource}} 类型、{{resource}}Schema、CRUD handler。
行：[Book, Author, Loan]
提示："为每行实例化模板；结构相同；更新路由索引。"
3 文件生成，全匹配模板；路由索引一次更新。
常见问题
- ⚠生成代码编译失败："SyntaxError: Unexpected token" → 要求模型输出含正确 import 的完整文件；用 `npx tsc --noEmit` 验证。
- ⚠错误：幻觉 API：模型调用不存在的函数 → 对照真实库文档检查并在 package.json 锁定版本。
- ⚠Error: Cannot find module 'xxx' → `npm install xxx`；生成代码常导入项目尚未安装的包。
最佳实践
- ✓保留一模板作真相源；重新生成，勿手改。
- ✓生成后 grep 未填占位符以捕获遗漏。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是模板代码生成？
用占位符模板为可重复结构生成代码。 它可帮助开发者快速理解 模板代码生成 的核心价值与适用场景。
如何开始使用模板代码生成？
开始使用 模板代码生成，建议先掌握以下要点：识别共享结构（带占位符模板）。
模板代码生成 的常见误区有哪些？
使用 模板代码生成 时常遇到的问题包括：生成代码编译失败："SyntaxError: Unexpected token" → 要求模型输出含正确 import 的完整文件；用 `npx tsc --noEmit` 验证。；错误：幻觉 API：模型调用不存在的函数 → 对照真实库文档检查并在 package.json 锁定版本。；Error: Cannot find module 'xxx' → `npm install xxx`；生成代码常导入项目尚未安装的包。。
模板代码生成 的最佳实践是什么？
模板代码生成 的最佳实践包括：保留一模板作真相源；重新生成，勿手改。；生成后 grep 未填占位符以捕获遗漏。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习模板代码生成？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。