DotNet 命令行开发

下载安装
- 下载 SDK
- 安装 SDK
- 绿色版
- - 下载
  - 绿化脚本
常用命令
- 创建 dotnet new
- 运行 dotnet run
- 发布应用 dotnet publish
- 更多命令
VSCode 调试
- 所需插件
- 调试 CS
配置
- 项目.csproj
- - 排除依赖关系
- launch.json
- tasks.json
参考资料

下载安装

下载 SDK

我们就下最新的好： .NET 8.0 SDK (v8.0.100) - Windows x64 Installer!

安装 SDK

直接运行，一路下一步即可。
在这里插入图片描述

绿色版

下载

https://download.csdn.net/download/jx520/88673976
将压缩包解压到目标路径，如： C:\dotnet

绿化脚本

将当前目录添加到系统环境变量 PATH。
以是 VBS 脚本，用于为 dotnet sdk 添加环境变量。

Set WshShell = WScript.CreateObject("WScript.Shell") ' 创建一个 WshShell 对象
currentDir = WshShell.CurrentDirectory ' 获取当前目录

' 以管理员权限运行自己（并把当前目录作为参数传过去）
If WScript.Arguments.Length = 0 Then 
    Set ObjShell = CreateObject("Shell.Application") 
	ObjShell.ShellExecute "wscript.exe", """" & WScript.ScriptFullName & """ """ & currentDir & """ RunAsAdministrator", , "runas", 1 
    WScript.Quit 
End if 

' 检查是否传递了当前目录作为参数
If WScript.Arguments.Count > 0 Then
    currentDir = WScript.Arguments(0)
	'MsgBox currentDir, vbOKOnly, "-当前目录-"
End If

' 读取当前的 PATH 环境变量
pathEnv = WshShell.Environment("SYSTEM").Item("Path")
MsgBox pathEnv, vbOKOnly, "当前环境变量 Path"

' 将当前目录追加到 PATH
updatedPath = pathEnv & ";" & currentDir

' 添加 DOTNET_ROOT 环境变量
WshShell.Environment("SYSTEM").Item("DOTNET_ROOT") = currentDir

' 更新 PATH 环境变量
WshShell.Environment("SYSTEM").Item("Path") = updatedPath

' 通知用户
MsgBox "已将当前目录添加到 PATH 环境变量中。", vbOKOnly, "环境变量更新"

' 暂停脚本执行
WScript.Sleep 3000

执行完脚本后新开一个 cmd 执行 dotnet --version 输出版本号则成功。

Microsoft Windows [版本 10.0.22000.1936]
(c) Microsoft Corporation。保留所有权利。

C:\>dotnet --version
8.0.100

注意：如果某些IDE环境无法识别新加的环境变量，则重启一下系统。

常用命令

先进入项目根目录

命令	说明	演示
dotnet new	.NET CLI 的模板实例化命令。比如：创建解决方案、项目、装卸模板包	`dotnet new <项目模板> -o <项目目录> -n <项目名称>`
dotnet run	调试运行
dotnet publish	发布应用	`dotnet publish -c Release -r <目标平台> --self-contained true`

创建 dotnet new

在C:/mysln 位置，创建一个解决方案

dotnet new sln -o C:/mysln
# 或：进入指定目录 `C:/mysln` 后再创建解决方案文件 `mysln.sln`
cd "C:/mysln"
dotnet new sln -n "mysln"

在C:/mysln/demo 位置，创建一个 C# 的 命令行项目，然后添加到解决方案
dotnet new "console" -lang "C#" -n <项目名称> -o <项目路径>

# 创建项目
cd "C:/mysln"
dotnet new "console" -lang "C#" -o "demo_path" -n "demo_name" 
# 添加到解决方案
dotnet sln "./mysln.sln" add "./demo_path/demo_name.csproj"

在 C:/mysln/windemo 位置，创建一个桌面应用项目，然后添加到解决方案

# 创建项目
cd "C:/mysln"
dotnet new "winforms" -lang "C#" -n "windemo" -o "windemo"
# 添加到解决方案
dotnet sln "./mysln.sln" add "./windemo/windemo.csproj"

运行 dotnet run

进入项目根目录，执行 dotnet run 即可运行

C:\>cd "C:/mysln/demo"
C:\mysln\demo>dotnet run
Hello, World!

发布应用 dotnet publish

发布当前项目（不带依赖，需要目标系统安装有相应的 .net 才能执行）

 dotnet publish -c Release -r win-x64

发布当前项目（包含依赖，可以直接执行，但无用的依赖没排除，文件有点大）

dotnet publish -c Release -r win-x64 --self-contained true

发布当前项目为单 exe（可以直接执行，排除了一部分无用依赖，还是比较大）

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true -p:TrimMode=link /p:IncludeNativeLibrariesForSelfExtract=true

要进一步优化排除无用依赖需要添加配置，详见：排除依赖关系

更多命令

可以在线看 dotnet 命令，也可以命令行 dotnet --help 查看

C:\>dotnet -h
使用情况: dotnet [runtime-options] [path-to-application] [arguments]

执行 .NET 应用程序。

runtime-options:
  --additionalprobingpath <path>   要探测的包含探测策略和程序集的路径。
  --additional-deps <path>         指向其他 deps.json 文件的路径。
  --depsfile                       指向 <application>.deps.json 文件的路径。
  --fx-version <version>           要用于运行应用程序的安装版共享框架的版本。
  --roll-forward <setting>         前滚至框架版本(LatestPatch, Minor, LatestMinor, Major, LatestMajor, Disable)。
  --runtimeconfig                  指向 <application>.runtimeconfig.json 文件的路径。

path-to-application:
  要执行的应用程序 .dll 文件的路径。

使用情况: dotnet [sdk-options] [command] [command-options] [arguments]

执行 .NET SDK 命令。

sdk-options:
  -d|--diagnostics  启用诊断输出。
  -h|--help         显示命令行帮助。
  --info            显示 .NET 信息。
  --list-runtimes   显示安装的运行时。
  --list-sdks       显示安装的 SDK。
  --version         显示使用中的 .NET SDK 版本。

SDK 命令:
  add               将包或引用添加到 .NET 项目。
  build             生成 .NET 项目。
  build-server      与由生成版本启动的服务器进行交互。
  clean             清理 .NET 项目的生成输出。
  format            将样式首选项应用到项目或解决方案。
  help              显示命令行帮助。
  list              列出 .NET 项目的项目引用。
  msbuild           运行 Microsoft 生成引擎(MSBuild)命令。
  new               创建新的 .NET 项目或文件。
  nuget             提供其他 NuGet 命令。
  pack              创建 NuGet 包。
  publish           发布 .NET 项目进行部署。
  remove            从 .NET 项目中删除包或引用。
  restore           还原 .NET 项目中指定的依赖项。
  run               生成并运行 .NET 项目输出。
  sdk               管理 .NET SDK 安装。
  sln               修改 Visual Studio 解决方案文件。
  store             在运行时包存储中存储指定的程序集。
  test              使用 .NET 项目中指定的测试运行程序运行单元测试。
  tool              安装或管理扩展 .NET 体验的工具。
  vstest            运行 Microsoft 测试引擎(VSTest)命令。
  workload          管理可选工作负荷。

捆绑工具中的其他命令:
  dev-certs         创建和管理开发证书。
  fsi               启动 F# 交互/执行 F# 脚本。
  user-jwts         在开发中管理 JSON Web 令牌。
  user-secrets      管理开发用户密码。
  watch             启动文件观察程序，它会在文件发生更改时运行命令。

运行 "dotnet [command] --help"，获取有关命令的详细信息。

VSCode 调试

所需插件

在这里插入图片描述

vscode-solution-explorer 用于管理解决方案（先打开一个目录，然后就可以：创建解决方案、创建项目…）上面讲的命令在这里都有对应的右键菜单
C# Dev Kit
1. 首次打开C#项目，VSCode 右下角会弹出此提示，点【安装】即可。
2. 安装 C# Dev Kit 后会自动装：.NET Install Tool、C#- IntelliCode for C# Dev Kit 提供自动完成

调试 CS

打开 CS 文件，按 F5 调试运行。

配置

项目.csproj

排除依赖关系

项目文件: C:/demo1/demo1.csproj

使用 <Trim> 和 <PublishTrimmed> 标签：
.NET Core 3.0 及以上版本引入了 trimming（修剪）功能，可以在发布时移除未使用的代码和依赖项。
在你的 .csproj 文件中添加以下内容：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
	...
    <PublishTrimmed>true</PublishTrimmed>
    <TrimMode>link</TrimMode>
  </PropertyGroup>

</Project>