共用方式為


管理全域套件、快取和暫存資料夾

當您安裝、更新或還原套件時,NuGet 會管理專案結構之外數個資料夾中的套件和套件資訊:

名稱 描述和位置 (依使用者)
global-packages global-packages 資料夾是 NuGet 安裝下載套件的位置。 每個套件已經完全展開至符合套件識別碼和版本號碼的子資料夾。 使用 PackageReference 格式的專案一律使用直接從此資料夾取得的套件。 當使用 packages.config 時,套件會安裝到 global-packages 資料夾,然後複製到專案的 packages 資料夾。
  • Windows:%userprofile%\.nuget\packages
  • Mac/Linux:~/.nuget/packages
  • 使用NUGET_PACKAGES環境變數、globalPackagesFolderrepositoryPath組態設定覆寫 (分別使用 PackageReference 和 packages.config時),或 RestorePackagesPath MSBuild 屬性 (僅限 MSBuild)。 環境變數的優先性高於組態設定。
http-cache Visual Studio 套件管理員 (NuGet 3.x+) 和 dotnet 工具會將下載的套件複本存放在此快取中 (另存為 .dat 檔案),並組織到每個套件來源的子資料夾。 套件不會展開,而且快取的到期時間為 30 分鐘。
  • Windows:%localappdata%\NuGet\v3-cache
  • Mac/Linux:~/.local/share/NuGet/v3-cache
  • 使用 NUGET_HTTP_CACHE_PATH 環境變數來覆寫。
temp NuGet 在其各種作業期間存放暫存檔的資料夾。
  • Windows:%temp%\NuGetScratch
  • Mac:/tmp/NuGetScratch
  • Linux:/tmp/NuGetScratch<username>
  • 使用 NUGET_SCRATCH 環境變數覆寫。
  • plugins-cache 4.8+ NuGet 在此資料夾中儲存來自作業宣告要求的結果。
    • Windows:%localappdata%\NuGet\plugins-cache
    • Mac/Linux:~/.local/share/NuGet/plugins-cache
    • 使用 NUGET_PLUGINS_CACHE_PATH 環境變數來覆寫。

    注意

    NuGet 3.5 和更早版本使用的是 packages-cache,而非位於 %localappdata%\NuGet\Cache 中的 http-cache

    NuGet 通常可使用快取和 global-packages 資料夾,以避免下載已經存在於電腦上的套件,藉此改善安裝、更新及還原作業的效能。 當使用 PackageReference 時,global-packages 資料夾也可避免將下載的套件保留在專案資料夾內 (以免可能會不小心新增到原始檔控制中),並降低 NuGet 對電腦儲存體的整體影響。

    NuGet 需要擷取套件時,首先會尋找 global-packages 資料夾。 如果套件的正確版本不存在,NuGet 便會檢查所有非 HTTP 套件來源。 如果仍然找不到套件,除非您使用 dotnet.exe 命令指定 --no-http-cache或使用 nuget.exe 命令指定 -NoHttpCache,否則 NuGet 會尋找 http-cache 中的套件。 如果套件不在快取中,或者未使用快取,則 NuGet 會透過 HTTP 擷取套件。

    如需詳細資訊,請參閱安裝套件後會發生什麼事

    檢視資料夾位置

    您可以使用 nuget locals 命令來檢視位置:

    # Display locals for all folders: global-packages, http cache, temp and plugins cache
    nuget locals all -list
    

    一般輸出 (Windows;"user1" 是目前使用者名稱):

    http-cache: C:\Users\user1\AppData\Local\NuGet\v3-cache
    global-packages: C:\Users\user1\.nuget\packages\
    temp: C:\Users\user1\AppData\Local\Temp\NuGetScratch
    plugins-cache: C:\Users\user1\AppData\Local\NuGet\plugins-cache
    

    (package-cache 使用於 NuGet 2.x 中,並在 NuGet 3.5 及更早版本中出現)。

    您可以使用 dotnet nuget locals 命令來檢視資料夾位置:

    dotnet nuget locals all --list
    

    一般輸出 (Mac;“user1” 是目前的使用者名稱:

    info : http-cache: /home/user1/.local/share/NuGet/v3-cache
    info : global-packages: /home/user1/.nuget/packages/
    info : temp: /tmp/NuGetScratch
    info : plugins-cache: /home/user1/.local/share/NuGet/plugins-cache
    

    一般輸出 (Linux;“user1” 是目前的使用者名稱:

    info : http-cache: /home/user1/.local/share/NuGet/v3-cache
    info : global-packages: /home/user1/.nuget/packages/
    info : temp: /tmp/NuGetScratchuser1
    info : plugins-cache: /home/user1/.local/share/NuGet/plugins-cache
    

    若要顯示單一資料夾的位置,請使用 http-cacheglobal-packagestempplugins-cache,不要使用 all

    清除本機資料夾

    如果遇到套件安裝問題,或想要確保安裝的是遠端資源庫的套件,請使用 locals --clear 選項 (dotnet.exe) 或 locals -clear (nuget.exe),指定要清除的資料夾,或 all 以清除所有資料夾:

    # Clear the 3.x+ cache (use either command)
    dotnet nuget locals http-cache --clear
    nuget locals http-cache -clear
    
    # Clear the 2.x cache (NuGet CLI 3.5 and earlier only)
    nuget locals packages-cache -clear
    
    # Clear the global packages folder (use either command)
    dotnet nuget locals global-packages --clear
    nuget locals global-packages -clear
    
    # Clear the temporary cache (use either command)
    dotnet nuget locals temp --clear
    nuget locals temp -clear
    
    # Clear the plugins cache (use either command)
    dotnet nuget locals plugins-cache --clear
    nuget locals plugins-cache -clear
    
    # Clear all caches (use either command)
    dotnet nuget locals all --clear
    nuget locals all -clear
    

    目前在 Visual Studio 中開啟且由專案使用的任何套件不會從 global-packages 資料夾清除。

    從 Visual Studio 2017 開始,使用 [工具 > NuGet 封裝管理員 封裝管理員 > [設定] 功能表命令,然後選取 [清除所有 NuGet 快取]。 目前無法透過套件管理員主控台來管理快取。 在 Visual Studio 2015 中,請改用 CLI 命令。

    用來清除快取的 NuGet 選項命令

    疑難排解錯誤

    使用 nuget localsdotnet nuget locals 時,可能會發生下列錯誤:

    • 錯誤:進程無法存取檔案 <套件,因為檔案套件> 正由另一個進程清除本機資源失敗:無法刪除一或多個檔案

      其他處理序正在使用資料夾內的一或多個檔案;例如,Visual Studio 專案已開啟,其中參照 global-packages 資料夾中的套件。 關閉這些處理序,並再試一次。

    • 錯誤:拒絕存取路徑或<>目錄不是空的

      您沒有刪除此快取中檔案的權限。 如果可能,請變更資料夾權限,並再試一次。 否則,請洽詢系統管理員。

    • 錯誤:「指定的路徑、檔案名稱或兩者都太長。 完整的檔名必須少於 260 個字元,並且目錄名稱必須少於 248 個字元。」

      請縮短資料夾名稱,並再試一次。