背景
當我們對ASP.Net Core內部的某些方法、類的實作感興趣時，有很多方法可以去了解，看書，看各種文章，但是最直接也是最深入的辦法就是去閱讀源代碼，
ASP.NET Core的源代碼托管在Github，專案地址是：https://github.com/dotnet/aspnetcore，
如果只是簡單的想看某個方法是如何實作的，我們可以直接在github網站上瀏覽，
但是通過網頁閱讀源代碼會遇到一些問題，首先是找到指定的類或方法并不容易，其次代碼的展示效果并不友好，
因此最佳的方式就是下載源代碼到我們本機，
下載源代碼
在GitHub上托管的專案的源代碼提供了幾種下載方式：
使用git、SVN、GitHub的客戶端，或者直接下載GitHub打包好的源代碼壓縮包，
如果是簡單的專案，你可以直接下載GitHub打包好的源代碼壓縮包，
但是對于ASP.NET Core這種大型專案，下載的源代碼壓縮包由于缺少子模塊的代碼，無法通過編譯，
不能通過編譯的代碼，下面這些功能無法使用：IDE提供的類和方法間的快速導航（F12），針對某個屬性、方法等查找它被哪些代碼所參考，
對于大型專案來說，缺少這些功能幾乎沒辦法深入閱讀該專案的源代碼，
尤其是ASP.NET Core這種大量使用了擴展方法的專案，擴展方法可能定義在一個不起眼的角落，通過手工查找繁瑣且困難，
所以強烈推薦使用git來克隆ASP.NET Core專案的倉庫：
git clone --recursive https://github.com/dotnet/aspnetcore
編譯的準備作業
現在，我們已經有源代碼了，但是由于ASP.NET Core專案使用了很多其他技術，所以編譯源代碼之前需要準備編譯環境，
不同的作業系統需求不一樣，以Windows環境下使用Visual Stuido舉例，當前官方檔案（3.1.1版本）上面列出的需求是：
- Windows 10 version 1803 或更新版本
- Visual Studio 2019
版本雖然沒有要求，但是實際依賴的部分組件會在更新版本的更新中包含，
例如，如果你編譯3.1.0版本的代碼，需要更新到16.4.4以上版本（包含新版本的MSBuild），
如果使用VS Code，請看后面的介紹， - Git https://git-scm.org
- NodeJS 10.14.2或更新版本 https://nodejs.org
- Java Development Kit 11 或更新版本
- Chrome 基于Selenium的測驗要用到
如果你使用的是其它環境（Linux或macOS， VS Code等），請查看詳細的安裝檔案（源代碼中的docs/BuildFromSource.md檔案），按照其中Install pre-requisites部分的指引準備編譯環境，
更細節的內容，比如編譯時怎么查找JDK的（如果你本機已經安裝過了，但是腳本提示找不到），你可以直接查看編譯腳本，.\build.ps1（或.\build.sh)檔案，
還原
當編譯環境準備好以后，記得開啟新的命令列視窗，因為新增的環境變數只在安裝后啟動的命令列中生效，
前面克隆到本機的是最新的代碼（更新頻繁），但是對于大多數人來說，我們只關注自己目前正在使用的版本，
ASP.NET Core所有版本的發布都打了標簽（tag），
因此，我們可以先使用git命令列出所有的版本，
git tag
然后根據標簽名稱，切換到我們的目標版本，比如3.1.0版本，
git checkout v3.1.0
在你使用Visual Studio或VS Code瀏覽代碼之前需要運行.\restore.cmd（Windows環境，Linux和macOS請使用對應的.sh檔案，下同）來還原編譯所依賴的運行環境和各種組件，
每次源代碼有大的更新時，你都需要重新運行.\restore.cmd，
運行.\restore.cmd后，腳本會立即開始檢查編譯所依賴的運行環境并下載各種組件（第一次運行時），
由于服務器都在國外，因此有些組件下載速度很慢，（如果某個組件下載速度很慢，kexue上網會有極大的改善）
首先會下載dotnet運行環境，這個是最大也是最慢的，做好心理準備，
它被存放在根目錄的.dotnet目錄下，差不多有1GB，
接下來開始下載各個專案所依賴的組件，這部分是通過nuget工具來下載的，
因為網路的原因，下載常常會出錯，在我的中國電信寬帶下反復重試依然如此，
因為nuget會在本地快取曾經下載過的組件，所以一旦發生上面的情況，你可以通過下面這種方式解決：
在VS中新建一個ASP.NET Core的專案，然后在管理NuGet包界面來下載這個包（這時候就能下載了，問號臉），
之后因為本地有快取了，再次通過命令列下載的時候就無需網路了，
在我本機編譯的程序中，遇到了找不到某個包的情況：Microsoft.Internal.AspNetCore.H2Spec.All 2.1.1，
手工在nuget.org上搜索居然沒有，后來在myget上找到了，還是先在Visual Studio的Package Manager Console中使用下面的這個命令先安裝在上面新建的專案中：
PM> Install-Package Microsoft.Internal.AspNetCore.H2Spec.All -Version 2.1.1 -Source https://dotnet.myget.org/F/aspnetcore-tools/api/v3/index.json
再次運行命令就能找到包了，
運行圖：
打開解決方案
打開解決方案
由于ASP.NET Core專案實在太大了——包含單元測驗在內有626個csproj檔案，8207個cs檔案——所以并沒有一個包含所有子專案的解決方案（.sln檔案），
在.\src目錄下面有很多子目錄，每一個子目錄都是一個子專案，每個子專案中都包含了一個解決方案（.sln檔案），
和我們平常打開自己的專案不一樣，ASP.NET Core的解決方案檔案(.sln)由于需要設定環境變數因此需要使用腳本命令來打開，
運行子目錄中的startvs.cmd即可啟動Visual Studio打開相應的子專案，
根據電腦配置，第一次啟動可能需要耗費相當長的時間，下次就快了，
下圖是MVC專案的解決方案，巨大無比吧，
現在，讓我們開始好好享受閱讀的樂趣吧，（手動狗頭）
如果你需要編譯源代碼的話，修改源代碼以后運行.\build.cmd檔案，然后你可以去泡茶了，回來應該就差不多了，（再次狗頭）
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/63166.html
標籤：.NET Core