C# 开发环境搭建（Avalonia UI、Blazor Web UI、Web API 应用示例）

文章目录

C# 文档NuGet.NET SDK 下载安装 .NET SDK安装完验证VS Code 配置C# 开发插件settings.json WPF UI 框架Avalonia UI 框架创建 Avalonia 项目Avalonia 官方示例Avalonia 桌面 UI 库 Blazor Web UI 框架创建应用项目结构 ASP.NET Core 控制器创建 Web APIdotnet 命令dotnet newdotnet builddotnet rundotnet tool

C# 文档

https://learn.microsoft.com/zh-cn/dotnet/csharp/tour-of-csharp/

NuGet

https://www.nuget.org/

.NET SDK 下载

https://dotnet.microsoft.com/zh-cn/download

安装 .NET SDK

安装完验证

dotnet -h# .NET SDK 版本dotnet --version# .NET SDK 的列表dotnet --list-sdks# .NET 运行时的列表dotnet --list-runtimes# .NET 安装和计算机环境详细信息dotnet --info

安装时正常会自动添加 PATH

# /usr/local/share/dotnet:~/.dotnet/toolsecho $PATH

VS Code 配置

C# 开发插件

C#C# Dev KitAvalonia for VSCode

settings.json

配置 Code Runner

{"code-runner.executorMap": {"csharp": "cd $dir && dotnet run $fileName"}}

创建一个 控制台应用

# 安装模板包dotnet new install Microsoft.NET.Runtime.WebAssembly.Templates# 根据 console 模板创建项目dotnet new console -o ./demo -n demo# 根据 console 模板创建项目，未指定名称则使用输出目录的名dotnet new console -o ./demo

运行 demo 项目

或者终端执行命令

dotnet run

WPF UI 框架

WPF（Windows Presentation Foundation）是微软推出的基于Windows 的用户界面框架。

文档： https://learn.microsoft.com/zh-cn/previous-versions/dotnet/netframework-4.0/ms742119(v=vs.100)

注： 本人是 Mac 电脑无法演示。

Avalonia UI 框架

Avalonia是一个强大的框架，使开发人员能够使用.NET创建跨平台应用程序。它使用自己的渲染引擎绘制UI控件，确保在Windows、macOS、Linux、Android、iOS和WebAssembly等不同平台上具有一致的外观和行为。这意味着开发人员可以共享他们的UI代码，并在不同的目标平台上保持统一的外观和感觉。

Github： https://github.com/AvaloniaUI/Avalonia

官网： https://avaloniaui.net/

文档： https://docs.avaloniaui.net/zh-Hans/docs/welcome

创建 Avalonia 项目

# 安装 Avalonia 模板dotnet new install Avalonia.Templates# 列出已安装的模板dotnet new list

# 创建 Avalonia 项目dotnet new avalonia.app -o democd demo# 运行项目dotnet run

Avalonia 官方示例

https://github.com/AvaloniaUI/Avalonia.Samples

git clone https://github.com/AvaloniaUI/Avalonia.Samples.gitcd Avalonia.Samplescd ./src/Avalonia.Samples/CompleteApps/SimpleToDoList

SimpleToDoList.csproj 修改为当前环境 .NET SDK 版本

<TargetFramework>net8.0</TargetFramework>

运行项目

dotnet run

Avalonia 桌面 UI 库

Github： https://github.com/kikipoulet/SukiUI

git clone https://github.com/kikipoulet/SukiUI.gitcd SukiUI/SukiUI.Demodotnet run

Blazor Web UI 框架

注： Blazor允许Web开发人员使用C#代替JavaScript创建Web应用程序。他们还可以重用.NET Silverlight代码。另外，Blazor应用程序由使用C＃，HTML和CSS实现的可重复使用的Web UI组件组成。由于客户端和服务器代码都是用C#编写的，因此开发人员可以共享代码和库。

ASP.Net Core 文档： https://dotnet.microsoft.com/zh-cn/learn/aspnet/blazor-tutorial/intro

Blazor 文档： https://learn.microsoft.com/zh-cn/aspnet/core/blazor/?view=aspnetcore-8.0&WT.mc_id=dotnet-35129-website

创建应用

dotnet new blazor -o BlazorApp

项目结构

Program.cs 是启动服务器以及在其中配置应用服务和中间件的应用的入口点。在 Components 目录中: App.razor 为应用的根组件。Routes.razor 配置 Blazor 路由器。Pages 目录包含应用的一些示例网页。 BlazorApp.csproj 定义应用项目及其依赖项。Properties 目录中的 launchSettings.json 文件为本地开发环境定义不同的配置文件设置。创建项目时会自动分配端口号并将其保存在此文件上。

运行应用

dotnet run

http://localhost:5291/

ASP.NET Core 控制器创建 Web API

创建 Web API 文档： https://learn.microsoft.com/zh-cn/training/modules/build-web-api-aspnet-core/?WT.mc_id=dotnet-35129-website

dotnet --list-sdksdotnet new webapi -controllers -f net8.0 -o demo

项目结构

名称	描述
Controllers/	包含公共方法公开为 HTTP 终结点的类。
Program.cs	配置服务和应用的 HTTP 请求管道，包含应用的托管入口点。
ContosoPizza.csproj	包含项目的配置元数据。
ContosoPizza.http	包含直接从 Visual Studio Code 测试 REST API 的配置。

运行应用

dotnet run

http://localhost:5223/weatherforecast

dotnet 命令

https://learn.microsoft.com/zh-cn/dotnet/core/tools/dotnet

dotnet new

dotnet new -h

列出要使用 dotnet new 运行的可用模板

dotnet new list

在 NuGet.org 上搜索 dotnet new 支持的模板

dotnet new search console

安装模板包

dotnet new install Microsoft.NET.Runtime.WebAssembly.Templates

卸载模板包

# 列出已安装的模板及其详细信息dotnet new --uninstall# 卸载 WebAssembly 模板包dotnet new uninstall Microsoft.NET.Runtime.WebAssembly.Templates

更新已安装的模板包

dotnet new update -h# 检查已安装模板包更新dotnet new update --check-only# 更新已安装模板包dotnet new update

dotnet build

生成项目及其所有依赖项

dotnet build -h

dotnet run

无需任何显式编译或启动命令即可运行源代码

dotnet run -hdotnet run --no-build

dotnet tool

dotnet tool -h# 列出全局或本地安装的工具dotnet tool list