.NET 开发者必备：全面整理常用 dotnet 命令

归档209

实用工具40 AI38 docker25 Hexo22 Linux15 娱乐15 Firefly14 工具推荐12 DotNet8 开发工具7 前端5 系统美化3 网站工具3 博客指南1 学习资源1

1131 字

6 分钟

.NET 开发者必备：全面整理常用 dotnet 命令

2024-10-23

浏览量加载中...

作为 .NET 开发者，你是否经常需要查找命令行指令？本文为你整理了开发过程中最常用的 dotnet 命令，涵盖项目创建、构建、测试、部署等多个方面，助你提升开发效率！

重要的操作命令#

一些常用的命名

创建并添加项目到解决方案#

1
# 创建 Web API 项目
2
dotnet new webapi -o MyWebApi
3

4
# 创建空解决方案
5
dotnet new sln -o MySolution
6

7
# 进入解决方案目录
8
cd MySolution
9

10
# 将 Web API 项目添加到解决方案中
11
dotnet sln add ../MyWebApi/MyWebApi.csproj

发布为独立部署应用（带运行时）#

1
# 发布 Web API 项目，配置为 Release，平台为 win-x64，且自带运行时
2
dotnet publish ../MyWebApi/MyWebApi.csproj -c Release -r win-x64 --self-contained

查看 SDK 和运行时信息#

1
# 查看所有已安装的 .NET SDK 版本
2
dotnet --list-sdks
3

4
# 查看所有已安装的 .NET 运行时版本
5
dotnet --list-runtimes

运行命令#

1
# 指定运行环境为 Development / Production
2
dotnet run --environment Development
3

4
# 指定监听地址（适用于 ASP.NET Core）
5
dotnet run --urls "http://*:5000;https://localhost:5001"
6
#localhost:5000 表示仅本机访问。
7
# 0.0.0.0:5001 表示允许外部机器通过 IP 访问。 Ubantu使用添加
8

9
# 运行指定项目的代码（不切换目录）
10
dotnet run -p ../MyWebApi/MyWebApi.csproj
11

12
# 显示详细构建日志输出
13
dotnet run --verbosity detailed

📁 一、项目与解决方案管理#

✅ 创建新项目#

1
# 创建控制台应用程序
2
dotnet new console -o MyConsoleApp
3

4
# 创建类库项目（Class Library）
5
dotnet new classlib -o MyLibrary
6

7
# 创建 ASP.NET Core Web API 项目
8
dotnet new webapi -o MyWebApi
9

10
# 创建 Blazor Server 项目
11
dotnet new blazorserver -o MyBlazorApp

📂 管理解决方案（.sln）#

1
# 创建一个新的解决方案文件
2
dotnet new sln -o MySolution
3

4
# 将项目添加到解决方案中
5
dotnet sln add MyProject.csproj
6

7
# 从解决方案中移除项目
8
dotnet sln remove MyProject.csproj
9

10
# 查看当前解决方案包含的所有项目
11
dotnet sln list

⚙️ 二、构建与运行项目#

1
# 恢复所有 NuGet 包依赖项
2
dotnet restore
3

4
# 构建项目，默认是 Debug 配置
5
dotnet build
6

7
# 构建发布版本（Release）
8
dotnet build --configuration Release
9

10
# 运行项目（自动先构建再运行）
11
dotnet run

📦 三、发布应用程序#

你可以选择发布为独立部署（Self-contained）或框架依赖（Framework-dependent）：

1
# 发布为独立部署应用（包含运行时），适用于目标机器无 .NET 安装的情况
2
dotnet publish -r win-x64 --self-contained
3

4
# 发布为框架依赖应用（需目标机器安装对应 .NET 运行时）
5
dotnet publish -r win-x64 --framework-dependent

🧪 四、测试与维护#

1
# 运行项目中的所有单元测试
2
dotnet test
3

4
# 只运行指定名称的测试方法/类
5
dotnet test --filter MyTest
6

7
# 列出当前项目直接引用的 NuGet 包
8
dotnet list package
9

10
# 列出包括传递依赖在内的所有包信息
11
dotnet list package --include-transitive
12

13
# 添加一个 NuGet 包引用
14
dotnet add package Newtonsoft.Json
15

16
# 移除一个 NuGet 包引用
17
dotnet remove package Newtonsoft.Json
18

19
# 添加对本地项目的引用（如类库）
20
dotnet add reference ../MyLib/MyLib.csproj

🧰 五、SDK 与环境信息#

1
# 显示当前默认使用的 SDK 和运行时详细信息
2
dotnet --info
3

4
# 列出系统中已安装的所有 .NET SDK 版本
5
dotnet --list-sdks
6

7
# 列出系统中已安装的所有 .NET 运行时版本
8
dotnet --list-runtimes
9

10
# 显示 dotnet CLI 的帮助信息
11
dotnet help
12

13
# 使用指定版本的 SDK 执行某个命令（例如使用 6.0.100）
14
dotnet --sdk-version 6.0.100 build

📦 六、NuGet 包管理#

1
# 恢复所有 NuGet 包（等价于 restore）
2
dotnet restore
3

4
# 清除本地 NuGet 缓存（解决缓存导致的问题）
5
dotnet nuget locals all --clear
6

7
# 将项目打包成 .nupkg 文件（用于私有或公共 NuGet 源发布）
8
dotnet pack
9

10
# 将 NuGet 包推送到指定源（如 nuget.org）
11
dotnet nuget push MyPackage.nupkg --source https://api.nuget.org/v3/index.json

🔧 七、其他实用命令#

1
# 调用 MSBuild 并执行自定义目标（Target）
2
dotnet msbuild /t:CustomTarget
3

4
# 查看详细的构建日志输出（用于调试构建问题）
5
dotnet build --verbosity detailed
6

7
# 启动 .NET Interactive 工具（支持 C# 即时执行和 Jupyter Notebook）
8
dotnet interactive
9

10
# 查看构建性能摘要（优化构建耗时）
11
dotnet build --performance-summary
12

13
# 使用本地安装的 dotnet tool
14
dotnet tool run <tool-name>
15

16
# 启用源码链接调试（调试 NuGet 包时跳转 GitHub）
17
dotnet run --sourceLink

🧪 八、调试与性能分析相关命令#

1
# 启用 AOT 编译（.NET 7+ 功能）
2
dotnet run --aot
3

4
# 收集内存使用情况（用于 PerfView 分析）
5
dotnet run --collect:Memory
6

7
# 启用单文件发布并运行（.NET 6+）
8
dotnet publish -r win-x64 --self-contained -p:PublishSingleFile=true
9
dotnet run --no-build --framework net6.0