如何将GitHub上的ASP.NET Core 7 Web API项目转为可复用模板?
将ASP.NET Core 7 Web API项目转为可复用模板的几种简便方法
方法1:制作.NET CLI模板(跨平台通用)
这是最灵活的方案,支持全平台,能通过命令行快速创建项目:
- 清理项目:移除本地配置目录(如
.git、bin、obj)、敏感信息(如appsettings里的JWT密钥,替换成__JWT_SECRET_PLACEHOLDER__这类占位符),确保项目只保留通用核心代码。 - 添加模板配置:在项目根目录新建
.template.config文件夹,里面创建template.json文件,示例配置如下:
{ "$schema": "http://json.schemastore.org/template", "author": "你的名字", "classifications": ["Web", "API", "JWT"], "name": "带JWT认证的ASP.NET Core 7 Web API", "shortName": "jwtapi", "identity": "JwtApi.Template", "tags": { "language": "C#", "type": "project" }, "sourceName": "你的原项目名称", "preferNameDirectory": true }
其中sourceName是你当前项目的名称,使用模板创建新项目时,CLI会自动把所有出现该名称的地方替换成用户输入的新项目名。
3. 打包并安装模板:
- 在项目根目录执行
dotnet pack,生成模板包(nupkg文件,默认在bin/Debug目录) - 执行
dotnet new install ./bin/Debug/[你的模板包文件名].nupkg完成安装
- 使用模板:执行
dotnet new jwtapi -n 你的新项目名,就能直接生成带JWT认证的Web API项目。
方法2:导出Visual Studio项目模板(适合VS用户)
如果平时用Visual Studio开发,直接导出模板更直观:
- 打开你的Web API项目,点击顶部菜单项目 -> 导出模板
- 选择项目模板,填写模板名称、描述,可自定义图标(可选)
- 导出完成后,下次新建项目时,在VS的项目模板列表里就能找到这个模板,直接选择创建即可。
方法3:设置GitHub模板仓库(快速复用仓库结构)
如果需要基于GitHub快速创建项目仓库,把现有仓库设为模板:
- 打开你的GitHub仓库页面,进入Settings页面,找到Template repository选项并勾选
- 之后每次新建项目,直接点击仓库页面的Use this template按钮,输入新项目名称,GitHub会自动创建一个基于该模板的新仓库,无需手动克隆重命名。
注意事项
- 模板中不要包含敏感信息,比如硬编码的密钥、本地数据库连接字符串,建议用占位符提示用户替换
- 定期更新模板:如果后续JWT认证逻辑有优化,直接更新模板项目后重新打包安装即可
内容的提问来源于stack exchange,提问作者DavidB
相关产品推荐
相关产品推荐

