Furion+SqlSugar环境配置与项目创建

一、速通一图流

二、安装 .NET 8

1. 下载与安装 .NET 8 SDK

访问 .NET 下载页面并下载最新版本的 .NET 8 SDK。
根据操作系统选择适合的安装包（如 Windows、macOS 或 Linux），并按照提示完成安装。

2. 验证安装

打开终端或命令提示符，运行以下命令以验证 .NET 8 是否成功安装：dotnet --version
如果安装成功，终端会显示当前安装的 .NET 版本号。

三、使用 Visual Studio 创建解决方案和项目

1. 创建解决方案

打开 Visual Studio，选择"创建新项目"。
选择"空白解决方案"模板，然后点击"下一步"。
设置解决方案的名称和保存位置，然后点击"创建"。

2. 添加项目

在解决方案资源管理器中右键点击解决方案，选择"添加 > 新建项目"。
选择"ASP.NET Core Web API"模板，点击"下一步"。
设置项目名称（例如 MyFurionApp）并选择保存位置。
选择 .NET 8 作为目标框架，然后点击"创建"。

3. 配置环境

在项目创建完成后，可以通过 NuGet 管理器或命令行工具安装所需的依赖包（如 Furion 和 SqlSugar）。

四、通过脚手架安装

Furion 官方提供了多种 Web 应用类型的脚手架，方便开发者快速创建多层架构项目。根据项目需求，可以选择合适的脚手架模板进行安装。

1. 安装 Furion + EFCore 脚手架

打开 CMD 或 Powershell，执行以下命令来安装所需的脚手架模板：

Shell 复制代码

# Mvc 模板
dotnet new install Furion.Template.Mvc

# WebApi 模板
dotnet new install Furion.Template.Api

# Mvc/WebApi 模板
dotnet new install Furion.Template.App

# RazorPages 模板
dotnet new install Furion.Template.Razor

# RazorPages/WebApi 模板
dotnet new install Furion.Template.RazorWithWebAPI

# Blazor 模板
dotnet new install Furion.Template.Blazor

# Blazor/WebApi 模板
dotnet new install Furion.Template.BlazorWithWebAPI

# Blazor App（Auto）模板，仅支持 .NET8 和 .NET9
dotnet new install Furion.Template.Blazor.App

2. 安装 Furion + SqlSugar 脚手架

对于使用 SqlSugar 的项目，可以选择以下命令安装相应的脚手架模板：

Shell 复制代码

# Mvc 模板
dotnet new install Furion.SqlSugar.Template.Mvc

# WebApi 模板
dotnet new install Furion.SqlSugar.Template.Api

# Mvc/WebApi 模板
dotnet new install Furion.SqlSugar.Template.App

# RazorPages 模板
dotnet new install Furion.SqlSugar.Template.Razor

# RazorPages/WebApi 模板
dotnet new install Furion.SqlSugar.Template.RazorWithWebAPI

# Blazor 模板
dotnet new install Furion.SqlSugar.Template.Blazor

# Blazor/WebApi 模板
dotnet new install Furion.SqlSugar.Template.BlazorWithWebAPI

# Blazor App（Auto）模板，仅支持 .NET8 和 .NET9
dotnet new install Furion.SqlSugar.Template.Blazor.App

注意：不带版本号的命令会始终安装最新的版本。

3. 用脚手架生成项目

在安装好脚手架模板后，可以使用以下命令生成项目：

Shell 复制代码

# 命令模板
dotnet new 关键词 -n 项目名称 -f .NET版本
# 示例：生成一个使用 Furion + SqlSugar 的 WebApi 项目，目标框架为 .NET 8
dotnet new fsapi -n MyFurionSqlSugarApp -f net8

注意：

生成的项目名称不能包含短横线等特殊字符，如需特殊字符可在生成后通过 Visual Studio 修改。
通过 dotnet new --list 命令查看所有可用模板。
使用 dotnet new 关键词 --help 查看更多参数。

五、项目解决报错（依赖性安装）

在使用 Furion 和 SqlSugar 脚手架创建项目时，可能会遇到一些常见的报错。以下是常见的报错及解决方案：

1 未找到依赖包

问题：在构建或运行项目时，可能会提示未找到某些依赖包。
解决方案：

确保在项目中正确安装了所需的 NuGet 包（如 Furion、SqlSugar）。
在终端中运行 dotnet restore 命令，以修复和恢复所有项目依赖。

2 版本冲突

问题：安装或使用某些包时，可能会遇到版本冲突问题。
解决方案：

检查所有已安装的包版本，确保版本兼容。如果存在版本冲突，尝试使用最新版本的包，或者手动指定兼容的版本号。
可以通过 NuGet 管理器或命令行手动调整包版本。

3 数据库连接失败

问题：在使用 SqlSugar 时，可能会遇到数据库连接失败的情况。
解决方案：

检查 appsettings.json 中的数据库连接字符串是否正确无误。
确保数据库服务已启动，并且防火墙允许该应用程序连接到数据库。
通过 SqlSugarScope 的日志功能调试连接问题。

4 MVC 添加区域出错

问题：由于 Furion 底层依赖了 Microsoft.CodeAnalysis.CSharp 包，可能在通过 Visual Studio 的界面添加 Area 区域时报错。
解决方案：

在 Web.Entry 层安装以下 NuGet 包：

Shell 复制代码

dotnet add package Microsoft.CodeAnalysis.CSharp.Features
dotnet add package Microsoft.CodeAnalysis.CSharp.Scripting
dotnet add package Microsoft.CodeAnalysis.VisualBasic.Features
dotnet add package Microsoft.CodeAnalysis.Workspaces.MSBuild
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design

安装这些包后，重新尝试添加区域。

4.5 其他依赖问题

问题：可能需要安装其他常用依赖包，如用于生成 API 文档的 Swashbuckle。
解决方案：

使用以下命令安装 Swashbuckle：

Shell 复制代码

dotnet add package Swashbuckle.AspNetCore

根据项目需求安装其他依赖包，并确保所有依赖已正确安装和配置。