每個C#開發者應該知道的5個快速.NET CLI命令
作為一名C#開發者,您可能對Visual Studio、VS Code或甚至像Writer這樣的輕量級編輯器已有所熟悉。 但正如Tim Corey在其影片0:00處指出的那樣,利用一些基本的.NET CLI命令可以顯著提升您的工作效率。 無論您是在處理.NET Core專案、ASP.NET Core網頁應用程式還是控制台專案,有效地使用命令列介面(CLI)能讓您精確且快速地建立、運行和部署您的.NET Core應用程式。
Tim的培訓著重於一個實用的經典10分鐘指南,介紹每個開發者都應該知道的五個命令。 他不著重於理論說明,而是在一個新建的Blazor網頁應用專案上演示這些命令,執行.NET 10,突出.NET Core SDK在專案目錄中的實際運用(0:33)。
介紹.NET CLI和.NET命令列介面
影片開頭,Tim強調即使您偏好使用像Visual Studio這樣的IDE,了解.NET命令列介面(CLI)仍然是至關重要的。 命令列介面CLI允許您直接與.NET Core應用程式互動,而無需依賴IDE。這在您希望啟動命令、執行明確的編譯或在使用Windows、Mac或Linux的跨平台工具環境中工作時特別有用。
Tim在1:15處還提供了一個快速的額外提示:運行
dotnet --info
此命令列出已安裝的.NET SDK版本、運行時套件存儲中的運行時套件、架構及其他環境詳細資訊。 這確認.NET Core CLI已安裝並隨時可用,這在探索其他命令前至關重要。
1. 使用dotnet build構建您的專案
Tim解釋的第一個命令是dotnet build。 此構建命令將您的源代碼編譯到輸出目錄中的DLL檔案,通常是bin/Debug/net10/或bin/Release/net10/。 Tim演示了清空bin目錄以移除先前編譯的檔案,確保乾淨的構建。
dotnet build
Tim解釋到,此命令會根據配置檔案和專案範本創建編譯輸出,不論是控制台應用程式、類庫還是ASP.NET Core應用程式。 構建命令至關重要,因為它確保您的.NET Core CLI確切知道要編譯什麼以及要包含哪些特定檔案。
使用構建命令也是更高階CLI命令如dotnet run或dotnet publish的前置條件。 Tim強調,儘管Visual Studio會自動處理構建,但了解使用dotnet build進行明確編譯在CI/CD流水線或核心命令列工作流程中有益。
2. 使用dotnet run運行您的應用程式
Tim的第二個命令是dotnet run,一個運行命令,將構建和執行您的.NET Core應用程式整合成一步。與dotnet build只編譯不同,**dotnet run會在當前終端或命令提示字元中執行應用程式。
dotnet run
使用他的Blazor網頁應用,Tim展示了dotnet run如何根據launchSettings.json配置檔啟動應用程式。默認的URL和HTTP端口自動選擇。 他使用Notepad編輯首頁,並指出更新不會即時反映,需重新運行dotnet run (5:02)。
此命令對於測試控制台應用程式、ASP.NET Core網頁應用,甚至引用其他DLL檔案的類庫專案都特別有幫助,使用dotnet add reference。 對於在.NET Core中運行單元測試的開發者,結合dotnet build和dotnet run確保指定的程序集對測試運行器已準備好。
3. 使用dotnet watch進行熱重新載入
為了消除對每次更改後重啟應用程式的需求,Tim介紹了dotnet watch,一個提供熱重新載入的文件監視CLI命令(5:44)。
dotnet watch
此CLI命令列介面會監控您專案目錄中的指定檔案,並自動將更改應用到正在運行的應用程式中。 Tim再次編輯首頁,將文本從"Hello YouTube"改回"Hello World",而瀏覽器在不重新啟動的情況下即時更新。
對於跨平台開發來說,文件監視功能是無價的,允許.NET Core開發者在像Notepad這樣的輕量級編輯器中工作,同時保留通常僅在Visual Studio或VS Code中可用的熱重新載入體驗。
4. 使用dotnet clean清理您的專案
有時.NET專案可能會有殘留的編譯檔案,造成錯誤或不一致。 Tim的第四個命令,dotnet clean,會移除輸出目錄和中間文件夾中的所有檔案,如bin/和obj/(7:06)。
dotnet clean
在運行此命令後,後續的構建將從頭開始,確保沒有任何DLL檔案或本地NuGet資源干擾。 Tim展示了在處理包含多個.NET Core專案或類庫專案使用nuget包的解決方案文件時,dotnet clean特別有用。
此命令確保開始運行單元測試的全新開始,使用dotnet test或準備專案進行部署。
5. 使用dotnet publish發佈您的專案
最後,Tim介紹dotnet publish,它準備您的.NET Core應用程式以便部署到托管系統如IIS、Azure或其他環境上。
dotnet publish
此CLI命令會編譯專案並將發佈的資產置於bin/Release/net10/的發佈文件夾下。 輸出包括所有指定的程序集、運行時包以及必要的開發證書以便託管。 Tim強調,這個命令適用於所有.NET Core專案,包括控制台應用程序、ASP.NET Core應用程式和類庫(8:18)。
結合dotnet pack創建NuGet包使用,dotnet publish也很有用,讓您的程式碼在多個.NET Core解決方案中可重用。
額外提示與備註
Tim指出,掌握這五個.NET Core CLI命令——dotnet build、dotnet run、dotnet watch、dotnet clean和dotnet publish——涵蓋了.NET Core開發中約85%的日常工作(9:01)。 他還提到其他命令選項及在線上提供的更詳細文檔,如果您想探索高级標誌、單元測試運行器或自定義專案模板。
對於新專案,開發者可以使用dotnet new console、dotnet new class library或其他指定模板快速生成.NET Core控制台應用程式或ASP.NET Core專案。 此外,dotnet restore幫助在構建之前還原本地NuGet資源和指定的程序集。
這些命令是跨平台的,這意味著相同的CLI命令列介面在Windows、Mac和Linux上都能運行。 它們也兼容專案模板、解決方案文件、控制台應用程式、類庫專案和模版-視圖-控制器應用程式,幾乎適用於所有.NET Core專案時具有通用性。
總結
這是Tim Corey推薦的五個必備.NET Core CLI命令的快速回顧:
-
dotnet build – 明確地將您的專案編譯到輸出目錄中的DLL檔案。
-
dotnet run – 立即構建和執行.NET Core應用程式。
-
dotnet watch – 通過文件監視器啟用熱重新載入,自動反映更改。
-
dotnet clean – 移除所有編譯文件和中間文件夾以進行全新構建。
- dotnet publish – 準備完整的.NET Core應用程式以便在任何托管系統上部署。
這些命令使開發者能夠有效地使用.NET CLI管理.NET Core專案、解決方案文件和控制台專案,而不完全依賴IDE.通過將它們納入您的工作流程,您可以自信地快速構建、運行、測試和部署您的.NET Core應用程式。
