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，执行以下命令来安装所需的脚手架模板：

# 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 的项目，可以选择以下命令安装相应的脚手架模板：

# 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. 用脚手架生成项目

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

# 命令模板
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 包：

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：

dotnet add package Swashbuckle.AspNetCore

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