.NET CLI 指令碼介紹

.NET CLI 是一組用於開發、構建、運行、發布 .NET 應用程序的命令行工具。以下是完整的介紹,包括常用命令及其使用方式。


1. 安裝與檢查版本

安裝 .NET SDK

前往 .NET 官方網站 下載並安裝適合您系統的 SDK。

檢查版本

dotnet --version

顯示已安裝的 .NET SDK 版本。

檢查所有已安裝的 SDK 和 Runtimes

dotnet --list-sdks
dotnet --list-runtimes

2. 項目相關命令

2.1 創建項目

使用 dotnet new 命令創建新項目。

範例:創建不同類型的項目

# 創建控制台應用程序
dotnet new console -o MyConsoleApp

# 創建 ASP.NET Core Web 應用程序
dotnet new webapp -o MyWebApp

# 創建 ASP.NET Core Web API
dotnet new webapi -o MyWebAPI

# 創建類庫
dotnet new classlib -o MyLibrary

# 創建單元測試項目
dotnet new xunit -o MyTests

# 查看所有模板
dotnet new --list

2.2 還原依賴項

csprojsln 文件中下載和安裝依賴項:

dotnet restore

2.3 編譯項目

構建項目並生成輸出:

dotnet build
  • 添加

    --configuration

    (或 -c)指定構建配置:

    dotnet build -c Release

2.4 運行項目

運行項目中的主程序(Program.cs):

dotnet run

3. 包管理

3.1 添加 NuGet 包

向項目中添加 NuGet 包:

dotnet add package <PackageName> --version <Version>

範例:

dotnet add package Newtonsoft.Json --version 13.0.1

3.2 查看已安裝的包

dotnet list package

3.3 升級 NuGet 包

dotnet add package <PackageName> --version <NewVersion>

4. 測試與調試

4.1 運行測試

運行單元測試項目:

dotnet test

4.2 查看測試結果格式

生成詳細的測試結果:

dotnet test --logger "trx;LogFileName=TestResults.trx"

5. 發布與部署

5.1 發布項目

生成可發布的文件:

dotnet publish -c Release -o ./publish
  • 發布自包含應用程序(不依賴 .NET Runtime):

    dotnet publish -r <RID> --self-contained true

    範例:

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

6. 解決方案與多項目管理

6.1 創建解決方案

dotnet new sln -n MySolution

6.2 添加項目到解決方案

dotnet sln add <ProjectPath>

6.3 刪除項目

dotnet sln remove <ProjectPath>

7. 查看與診斷

7.1 查看已安裝模板

dotnet new --list

7.2 查看項目依賴項樹

dotnet list package --vulnerable

7.3 查看可用命令

dotnet --help

8. 版本管理

8.1 全局工具安裝

安裝 .NET CLI 工具:

dotnet tool install -g <ToolName>

範例:

dotnet tool install -g dotnet-ef

8.2 更新工具

dotnet tool update -g <ToolName>

8.3 卸載工具

dotnet tool uninstall -g <ToolName>

9. 常見的進階操作

9.1 執行腳本或 DLL

直接運行已編譯的 DLL 文件:

dotnet <PathToDll>

9.2 本地生成 Docker 映像

如果項目包含 Docker 支持,可以使用:

dotnet publish -c Release -o out
docker build -t myapp:latest .

參考資源

  • 官方文檔:.NET CLI Documentation

  • 提示:在每個命令後添加 --help 可以查看該命令的所有可用參數。

Last updated