.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 還原依賴項
從 csproj
或 sln
文件中下載和安裝依賴項:
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 .
參考資源
提示:在每個命令後添加
--help
可以查看該命令的所有可用參數。
Last updated