官方文档

微软的开发者文档，是我见过最完善，也最容易迷路的官方文档。功能齐全，叙述详尽，更新活跃，组织架构却令人迷惑，不知线头该从哪里开始缕。
后来又发现，之前文档的官网，居然换域名了:
https://docs.microsoft.com/ -> https://learn.microsoft.com/
还是习惯原来的docs子域名。

• dotnet大家族
• dotnet基础

官方下载

下载入口: https://dotnet.microsoft.com/download

新建项目

新建项目: dotnet new <TEMPLATE>

dotnet new 命令 基于模板 创建项目。

• -n|--name: 所创建的输出的名称。 如果未指定名称，使用的是当前目录的名称。
• -o|--output: 用于放置生成的输出的位置。 默认为当前目录。
• -?|-h|--help: 打印命令帮助。 可针对 dotnet new 命令本身或任何模板调用它。 例如 dotnet new mvc --help。

示例:

# 创建项目到新目录
dotnet new console -o sample1
cd sample1
dotnet run

# 在当前目录创建项目
dotnet new console
dotnet run

列出已安装的模板:

# dotnet6
dotnet new --list [<TEMPLATE_NAME>]
# dotnet7
dotnet new list [<TEMPLATE_NAME>]
# 列出所有已安装的模板。list后添加参数，则兼具搜索功能

安装模板:

# dotnet6
dotnet new --install <PATH|NUGET_ID>
# dotnet7
dotnet new install <PATH|NUGET_ID>

打包发布（交叉编译）

dotnet publish 编译应用程序、读取 project 文件的依赖项，生成文件集并发布到目录。
详情请移步官方文档: 项目发布(dotnet publish)

dotnet publish -c Release

• -c|--configuration: 定义生成配置。 大多数项目的默认配置为 Debug
• -r|--runtime: 发布针对给定运行时的应用程序。参数为运行时标识符(RID)，如果使用此选项，则还要使用 --self-contained 或 --no-self-contained
• -a|--arch: 指定目标体系结构。是设置运行时标识符(RID)的简写语法。例如，在 win-x64 计算机上，指定 --arch x86 会将 RID 设置为 win-x86。 如果使用此选项，请不要使用 -r|--runtime 选项。
• --os: 指定目标操作系统 (OS)。是设置运行时标识符(RID)的简写语法。例如，在 win-x64 计算机上，指定 --os linux 会将 RID 设置为 linux-x64。 如果使用此选项，请不要使用 -r|--runtime 选项

添加依赖包

dotnet add package Newtonsoft.Json

版本升级

如 dotnet5 -> dotnet6 在新的 .NET 环境中，执行以下步骤:

1. 安装项目模板(可选): 例: dotnet new --install AntDesign.Templates
2. 从模板新建项目: 例: dotnet new antdesign -o blazorantd --host wasm
3. 修改.csproj文件: 对比新老项目的blazorantd.csproj文件，根据版本号，修改原有项目依赖项