共用方式為

匯入或匯出安裝組態

  • 發行項

您可以使用安裝組態檔來設定 Visual Studio 安裝的內容。 若要這樣做，請使用 Visual Studio 安裝程式，將工作負載、元件和 Marketplace 擴充功能資訊導出至 .vsconfig 檔案。 一旦擁有 .vsconfig 檔案後，您可以進一步手動調整，並新增或移除其他項目。 .vsconfig 檔案的結構和語法會在 區段 vsconfig 檔案格式中說明。

您也可以將組態檔匯入新的或現有的Visual Studio安裝、使用它來建立或修改版面配置或離線安裝、將它放入方案目錄或存放庫，並觸發遺失元件的安裝，並與其他人共用。

使用 Visual Studio 安裝程式匯出組態

您可以從先前安裝的 Visual Studio 實體匯出安裝組態檔。

注意

從 Visual Studio 2022 17.10 版預覽版開始，您可以將 Visual Studio Marketplace 延伸 模組導出至實例範圍內容中載入的 .vsconfig 檔案。 如果您希望 export 功能能夠匯出其他類型的擴充功能，例如從網路共用或使用者內容載入的擴充功能，請告訴我們。

使用 Visual Studio 安裝程式 UI

  1. 從 [開始] 功能表中，開啟 Visual Studio 安裝程式。

  2. 在產品卡片上，選擇 [更多] 按鈕，然後選取 [匯出組態]。

    Visual Studio 安裝程式中產品卡片匯出設定的螢幕快照。

  3. 瀏覽至或輸入您要儲存 .vsconfig 檔案的位置，然後選擇 [檢閱詳細資料] 。

    安裝組態中 [匯出位置] 欄位的螢幕快照。

  4. 確認您的選取項目正確無誤，然後選擇 [匯出]。

以程式設計方式匯出組態檔

您可以使用 export 動詞，以程式設計方式匯出特定 Visual Studio 實例的組態檔。 如需詳細資訊，請參閱 使用命令行參數來安裝、更新及管理 Visual Studio。

使用 Visual Studio 安裝程式匯入設定

您可以將安裝組態檔匯入先前安裝的Visual Studio實例中，或使用它初始化Visual Studio的新安裝。 將組態檔匯入 Visual Studio 會安裝尚未安裝的組態檔中列出的任何專案。

使用 Visual Studio 安裝程式 UI

當您準備好匯入安裝組態檔時，請遵循下列步驟。

  1. 開啟 Visual Studio 安裝程式並關閉 Visual Studio。 大部分的安裝程式作業都需要關閉 Visual Studio 產品本身。

  2. 在 [已安裝 ] 標籤或 [可用] 標籤上，選取 Visual Studio 產品卡片上的 [更多>匯入組態]。

  3. 找出您想要匯入的 .vsconfig 檔案，然後選擇 [檢閱詳細數據] 。

  4. 請確認您的選取項目正確無誤，然後選擇 修改。

使用設定檔以程式化方式將元件新增到現有安裝中

您可以使用 --config 參數來初始化或修改現有的安裝和新增元件。 下列範例會使用用戶端電腦上的安裝程式來 modify 現有的安裝。

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

注意

若要使用 .vsconfig 檔案將元件新增至現有的安裝，您必須使用 modify，不要update。 update 命令只會將現有的已安裝元件更新為最新版本。 若要深入瞭解不同的安裝程序作業，請參閱 從命令列安裝 Visual Studio 檔。

使用組態檔來初始化版面配置的內容

使用與您想要之 Visual Studio 版本和版本組對應的正確啟動載入器，開啟系統管理員命令提示字元，然後執行下列命令，用 --config 參數來設定版面配置的內容。 如需有關使用 .vsconfig 檔案從版面配置進行初始化和安裝的詳細資訊，請參閱 使用組態檔初始化版面配置的內容。

vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US

使用組態檔自動安裝遺漏的元件

如果您將 .vsconfig 檔案儲存到您的方案根目錄，然後開啟方案，Visual Studio 會自動偵測任何遺失的元件，並提示您安裝它們。

注意

如果您的 .vsconfig 檔案包含擴充功能，則目前只有那些託管在“Visual Studio Marketplace” 上的擴充功能， 會觸發自動 缺失 偵測和安裝。 如果您要此邏輯包含從非 Marketplace 位置安裝的擴充功能，請 在這裡提供案例的詳細資料，。

方案總覽的螢幕快照，其中建議其他元件。

您也可以從 [方案總管] 產生 .vsconfig 檔案。

  1. 以滑鼠右鍵點擊您的解決方案檔案。

  2. 選擇 新增>安裝組態檔。

  3. 確認您要儲存 .vsconfig 檔案的位置，然後選擇 [檢閱詳細資料] 。

  4. 確認您需要的工作負載和元件已準備好，然後選擇 匯出。

我們還創建了一個開放原始碼的工具，來遞迴地定位 Visual Studio 的安裝組態 .vsconfig 檔案，並將它們全部合併到一起。 若要深入瞭解此公用程式，請參閱 GitHub 上的 VSConfigFinder。

vsconfig 檔案格式

.vsconfig 檔案是 json 檔格式，其中包含 components 區段和選擇性的 extensions 區段。 元件區段包含 工作負載和元件，如下所示：

{
  "version": "1.0", 
  "components": [ 
    "Microsoft.VisualStudio.Component.CoreEditor", 
    "Microsoft.VisualStudio.Workload.CoreEditor", 
    "Microsoft.VisualStudio.Component.NuGet" 
    ] 
}

擴充

從 Visual Studio 2022 17.9 版開始，您可以在 .vsconfig 檔案中指定延伸模組，並使用 Visual Studio 安裝程式來載入它們，讓所有使用者都能使用。 從 Visual Studio 2022 17.10 版 Preview 開始，您可以使用 Visual Studio 安裝程式，將 Visual Studio Marketplace 延伸模組 export 到實例內容中載入的 .vsconfig 檔案，如先前所述 所述。

在組態檔中支援延伸模組時，有一些已知的限制。

  • 由於透過組態檔載入的延伸模組會安裝在整體實例中，因此您必須具有系統管理員權限，或已透過 AllowStandardUserControl 原則獲得控制安裝程式的權限，才能安裝它們。 Visual Studio 擴充功能管理員先前安裝的任何擴充功能，都能夠（且通常是）安裝於個別使用者，而不是全域範圍，且使用者不需要具有系統管理員許可權即可安裝。
  • Visual Studio 安裝程式目前僅支援匯入某些類型的擴充功能，例如包含在 *.vsix 套件中，或那些未 複雜。 如果您有未正確透過組態檔載入的延伸模組，請透過新的 開發人員社群建議讓我們知道。
  • 只有裝載在 Visual Studio Marketplace 上的擴充功能， 在方案目錄中，觸發自動 遺漏偵測和 安裝。 如果您要此邏輯包含從非 Marketplace 來源安裝的擴充功能，請在這裡詳細說明您的情況，。
  • 如果您是以程序設計方式使用 .vsconfig 檔案來新增延伸模組，則您也需要使用 --allowUnsignedExtensions 參數來允許 未簽署的 延伸模組載入 --passive 或 --quiet 內容中。 如果您要從版面配置安裝，您可以將 "allowUnsignedExtensions" : true 語法新增到 response.json 檔案，實現類似效果。

所有整個實例的擴充功能都會透過排程的工作自動更新約每天一次。 如需詳細資訊，請參閱 自動擴充功能更新。

.vsconfig 包含擴展名的檔格式看起來應該像這樣。

{
  "version": "1.0", 
  "components": [ 
    // Whatever components you want to install come here, in quotes, separated by commas.
    // You can use the installer to select the components you want to install and then export them,
    // Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
    // This array should not be null! If you don't want to install any component, just leave the array empty.
  ],
  "extensions": [
    // The extensions you want to install are specified in this section, in quotes, separated by commas.
    // Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
    // The extensions must be in a *.vsix package
    // Make sure that the extensions you specify are designed to work with that version of Visual Studio.
    // examples below
    "https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit",   //unsigned extension
    "https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer",  //signed extension
    "c:\\mylocaldrive\\someextension.vsix",
    "\\\\server\\share\\myextension.vsix",
    "https://myweb/anotherextension.vsix"
  ]
}

支援或疑難解答

有時候，事情可能會出錯。 如果您的 Visual Studio 安裝失敗，請參閱 Visual Studio 安裝和升級問題的疑難排解，以獲得詳細說明。

以下是一些更多支援選項：

相關內容