2.2 官方脚手架

📝 模块更新日志

• 突破性变化

  •   升级 脚手架支持创建 .NET8 Preview.1 项目 ^{4.8.7 ⏱️2023.02.22}

• 其他更改

  •   调整 脚手架模板，默认启用主流文件类型 MIME 支持 ^{4.8.7.5 ⏱️2023.03.07} e35cdab

特别说明

脚手架不是安装在项目中的！ 而是通过 CMD 或 PowerShell 安装到操作系统中的。

2.2.1 脚手架

Furion 官方提供了多种 Web 应用类型的脚手架，方便大家快速创建多层架构项目。目前支持以下应用脚手架：

2.2.1.1 Furion + EFCore

模板类型	名称	版本	关键词	描述
	Furion.Template.Mvc		👉 furionmvc	Mvc 模板
	Furion.Template.Api		👉 furionapi	WebApi 模板
	Furion.Template.App		👉 furionapp	Mvc/WebApi 模板
	Furion.Template.Razor		👉 furionrazor	RazorPages 模板
	Furion.Template.RazorWithWebApi		👉 furionrazorapi	RazorPages/WebApi 模板
	Furion.Template.Blazor		👉 furionblazor	Blazor 模板
	Furion.Template.BlazorWithWebApi		👉 furionblazorapi	Blazor/WebApi 模板

2.2.1.2 Furion + SqlSugar

模板类型	名称	版本	关键词	描述
	Furion.SqlSugar.Template.Mvc		👉 fsmvc	Mvc 模板
	Furion.SqlSugar.Template.Api		👉 fsapi	WebApi 模板
	Furion.SqlSugar.Template.App		👉 fsapp	Mvc/WebApi 模板
	Furion.SqlSugar.Template.Razor		👉 fsrazor	RazorPages 模板
	Furion.SqlSugar.Template.RazorWithWebApi		👉 fsrazorapi	RazorPages/WebApi 模板
	Furion.SqlSugar.Template.Blazor		👉 fsblazor	Blazor 模板
	Furion.SqlSugar.Template.BlazorWithWebApi		👉 fsblazorapi	Blazor/WebApi 模板

2.2.2 安装脚手架

打开 CMD 或 Powershell 执行模板安装命令（新版本 --install 可换成 install）：

// EFCore
dotnet new --install Furion.Template.Api::4.8.7.11
// SqlSugar
dotnet new --install Furion.SqlSugar.Template.Api::4.8.7.11

SqlSugar 脚手架基本使用

在 SqlSugar 脚手架中，Core 层包含了一个 DbContext.cs 类，可通过 DbContext.Instance 就可以获取到 SqlSugarScope 对象。

数据库链接字符串在启动层 appsettings.json 文件的 ConnectionConfigs 节点中配置，对应的是 SqlSugar 中的 ConnectionConfig[] 对象。

2.2.3 使用脚手架

dotnet new furionapi -n 项目名称 -f .NET版本

# EFCore：支持创建 .NET5-8 版本
dotnet new furionapi -n MyProject -f net5
dotnet new furionapi -n MyProject -f net6
dotnet new furionapi -n MyProject -f net7
dotnet new furionapi -n MyProject -f net8

# SqlSugar：支持创建 .NET5-8 版本
dotnet new fsapi -n MyProject -f net5
dotnet new fsapi -n MyProject -f net6
dotnet new fsapi -n MyProject -f net7
dotnet new fsapi -n MyProject -f net8

这样就可以生成项目代码了，生成之后推荐将所有的 nuget 包更新到最新版本。

关于项目名称和 .NET 版本

通过脚手架生成的项目名称不能包含 短横线 等特殊字符，如有该需求，可在生成之后通过 Visual Studio 进行手动修改。

-f 版本参数所有选项：net5，net6，net7，net8，默认是 net7。

特别提醒

furionapi 对应的是上面列表的 关键字，我们也可以通过 dotnet new --list 查看。

想了解更多可以使用 dotnet new 关键字 --help 查看更多参数。

2.2.4 脚手架更新

只需要重新安装最新版替换即可，如：

dotnet new --install Furion.Template.Api::4.8.7.11

不带版本号总是安装最新的版本。

2.2.5 Visual Studio 集成

通过命令安装脚手架后，升级 Visual Studio 到最新版可使用可视化方式创建哦。

2.2.6 关于 MVC 添加区域出错问题

由于 Furion 底层依赖了 Microsoft.CodeAnalysis.CSharp 包，所以可能通过 Viusal Studio 的界面添加 Area 区域 时会出错，这时候只需要在 Web.Entry 层安装下面几个包即可：

• Microsoft.CodeAnalysis.CSharp.Features
• Microsoft.CodeAnalysis.CSharp.Scripting
• Microsoft.CodeAnalysis.VisualBasic.Features
• Microsoft.CodeAnalysis.Workspaces.MSBuild
• Microsoft.VisualStudio.Web.CodeGeneration.Design

2.2.7 搭建脚手架

脚手架可以极大的提高我们搭建新项目的速度，推荐两篇文章给大家学习：

https://www.cnblogs.com/laozhang-is-phi/p/10205495.html

https://www.cnblogs.com/catcher1994/p/10061470.html

推荐直接拷贝 Furion 脚手架文件夹进行修改，可避免很多问题。

Furion 脚手架源码

2.2.8 反馈与建议

与我们交流

给 Furion 提 Issue。

---

了解更多

想了解更多 模板知识 知识可查阅 dotnet-new 模板 章节。