为什么需要自定义模板
在微服务架构下,每个新服务的启动往往伴随着大量重复工作:引用基础类库、配置 AutoMapper、初始化错误处理类等。虽然手动操作并不复杂,但频繁执行容易出错且耗时。与其每次都从零开始,不如将这套标准流程固化为一个 dotnet new 模板,让新项目生成变得像搭积木一样简单。
环境准备
动手之前,请确保你的机器上安装了以下工具:
- .NET Core 2.0 SDK 或更高版本
- 一个已经编译运行正常的现有微服务项目
- NuGet 命令行工具(nuget.exe)
构建模板结构
核心思路是将现有的微服务项目作为'种子',通过特定的目录结构包装成模板包。
首先,找到你确认可以正常运行的微服务项目根目录。在该目录下创建一个名为 Content 的文件夹,并将整个项目文件复制进去。接着,在 Content 文件夹内新建 .template.config 目录,用于存放模板的配置信息。
在这个配置目录中,我们需要创建 template.json 文件。这个文件定义了模板的身份和元数据。注意,JSON 格式必须严格有效,不要包含注释。
{
"$schema": "http://json.schemastore.org/template",
"author": "YourName",
"classifications": [ "microService", "Console" ],
"identity": "Quantum.MicroService",
"name": "微服务 Application",
"shortName": "qms",
"tags": { "language": "C#" },
"sourceName"

