install 命令 (NuGet CLI)

適用於: 套件耗用量 • 支援的版本: 全部

使用指定的套件來源,將套件下載並安裝至專案,預設為目前資料夾。

提示

若要直接在專案內容之外下載套件,請流覽 nuget.org 上的套件頁面,然後選取 [下載] 連結。

如果未指定任何來源,則會使用全域組態檔 %appdata%\NuGet\NuGet.Config (Windows) 或 ~/.nuget/NuGet/NuGet.Config (Mac/Linux) 中列出的來源。 如需其他詳細數據,請參閱 常見的 NuGet 組態

如果未指定任何特定套件, install 請安裝項目 packages.config 檔案中列出的所有套件,使其類似 restore

命令 install 不會修改項目檔或 packages.config;如此一來,它就如同 restore 它只會將套件新增至磁碟,但不會變更專案的相依性。

若要新增相依性,請在 Visual Studio 中透過 封裝管理員 UI 或控制台新增套件,或修改 packages.config ,然後執行 installrestore

使用方式

nuget install <packageID | configFilePath> [options]

其中 <packageID> 會命名要安裝的套件(使用最新版本),或 <configFilePath> 識別 packages.config 列出要安裝的套件的檔案。 您可以使用 選項來指出特定版本 -Version

選項。

  • -ConfigFile

    要套用的 NuGet 組態檔。 如果未指定, %AppData%\NuGet\NuGet.Config 則會使用 (Windows) 或 ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux)。

  • -DependencyVersion

    (4.4+) 要使用的相依性套件版本,可以是下列其中一項:

    • 最低 (預設值):最低版本
    • HighestPatch:具有最低主要、最低次要、最高修補程式的版本
    • HighestMinor:具有最低主要、最高次要、最高修補程式的版本
    • 最高:最高版本
    • 忽略:不會使用任何相依性套件

  • -DirectDownload

    直接下載,而不用元數據或二進位檔填入任何快取。

  • -DisableParallelProcessing

    停用平行安裝多個套件。

  • -x|-ExcludeVersion

    將套件安裝到只具有套件名稱,而不是版本號碼的資料夾。

  • -FallbackSource

    (3.2+) 在主要或預設來源中找不到套件時,要當做後援使用的套件來源清單。

  • -ForceEnglishOutput

    (3.5+) 強制nuget.exe使用非變異的英文文化特性來執行。

  • -Framework

    (4.4+) 用於選取相依性的目標架構。 如果未指定,則預設為 『Any』。

  • -?|-help

    顯示命令的說明資訊。

  • -NoHttpCache

    防止 NuGet 使用 HTTP 快取套件。 請參閱 管理全域套件和快取資料夾

  • -NonInteractive

    隱藏使用者輸入或確認的提示。

  • -OutputDirectory

    指定安裝套件的資料夾。 如果未指定任何資料夾,則會使用目前的資料夾。

  • -PackageSaveMode

    指定要在套件安裝之後儲存的檔案類型:、 或 nuspec;nupkgnuspecnupkg其中一個。

  • -PreRelease

    允許安裝發行前版本套件。 使用 還原套件 packages.config時,不需要此旗標。

  • -RequireConsent

    確認在下載並安裝套件之前已啟用還原套件。 如需詳細資訊,請參閱 套件還原

  • -SolutionDirectory

    指定要還原封裝之解決方案的根資料夾。

  • -Source

    指定要使用的套件來源清單(作為URL)。 如果省略,命令會使用組態檔中提供的來源,請參閱 一般 NuGet 組態

  • -Verbosity [normal|quiet|detailed]

    指定輸出中顯示的詳細資料量: normal (預設值), quietdetailed

  • -Version

    指定要安裝的套件版本。

另請參閱 環境變數

範例

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj