Update Visual Studio to the most recent release

We encourage you to update to the most recent release of Visual Studio 2017 so that you always get the latest features, fixes, and improvements.

And if you’d like to try out our newest version, consider downloading and installing Visual Studio 2019 instead.

You must log on with an account that has administrative permissions to install, update, or modify Visual Studio. For more information, see User Permissions and Visual Studio.

This topic applies to Visual Studio on Windows. For Visual Studio for Mac, see Update Visual Studio for Mac.

Update Visual Studio 2017 version 15.6 or later

We’ve streamlined the installation and update experience to make it easier to use directly from within the IDE. Here’s how to update from version 15.6 and later to newer versions of Visual Studio.

Using the Notifications hub

When there’s an update, there’s a corresponding notification flag in Visual Studio.

Choose the notification flag to open the Notifications hub, and then choose the update that you want to install.

An update for an edition of Visual Studio 2017 is cumulative, so always choose to install the one with the most recent version number.

When the Update dialog box opens, choose Update Now.

If a User Access Control dialog box opens, choose Yes. Next, a «Please wait» dialog might open for a moment, and then the Visual Studio Installer opens to start the update.

Your update continues. Then, when it’s complete, Visual Studio restarts.

When you run Visual Studio in administrator mode, you must manually restart Visual Studio after the update.

Using the IDE

You can check for an update and then install the update from the menu bar in Visual Studio.

Choose Help > Check for Updates.

When the Update dialog box opens, choose Update Now.

The update proceeds as described in the previous section, and then Visual Studio restarts after the update completes successfully.

When you run Visual Studio in administrator mode, you must manually restart Visual Studio after the update.

Using the Visual Studio Installer

As in earlier versions of Visual Studio, you can use the Visual Studio Installer to install an update.

Open the installer. The Visual Studio Installer might require updating before you continue.

On a computer running Windows 10, you can find the installer under the letter V as the Visual Studio Installer, or under the letter M as the Microsoft Visual Studio Installer.

On the Product page in the installer, look for the edition of Visual Studio that you installed previously.

If an update is available, you see an Update button. (It might take a few seconds for the installer to determine whether an update is available.)

Choose the Update button to install the updates.

Update Visual Studio 2017 version 15.5 or earlier

If you’re using an earlier version, here’s how to apply an update from Visual Studio 2017 version 15.0 through version 15.5.

Update by using the Notifications hub

When there are updates, there’s a corresponding notification flag in Visual Studio.

Choose the notification flag to open the Notifications hub.

An update for an edition of Visual Studio 2017 is cumulative, so always choose to install the one with the most recent version number.

Choose «Visual Studio Update» is available, which opens the Extensions and Updates dialog box.

In the Extensions and Updates dialog box, choose the Update button.

More about Visual Studio notifications

Visual Studio notifies you when an update is available for Visual Studio itself or for any components, and also when certain events occur in the Visual Studio environment.

• When the notification flag is yellow, there’s a Visual Studio product update available for you to install.
• When the notification flag is red, there’s a problem with your license.
• When the notification flag is black, there are optional or informational messages to review.

Choose the notifications flag to open the Notifications hub and then choose the notifications that you want to act on. Or, choose to ignore or dismiss a notification.

If you choose to ignore a notification, Visual Studio stops showing it. If you want to reset the list of ignored notifications, choose the Settings button in the Notifications hub.

Update by using the Visual Studio Installer

Open the installer. You might need to update the installer before continuing. If this is the case, you’re prompted to do so.

On a computer running Windows 10, you can find the installer under the letter V as the Visual Studio Installer, or under the letter M as the Microsoft Visual Studio Installer.

On the Product page in the installer, look for the edition of Visual Studio that installed previously.

If an update is available, you see an Update button. (It might take a few seconds for the installer to determine whether an update is available.)

Choose the Update button to install the updates.

We encourage you to update to the most recent release of Visual Studio 2019 so that you always get the latest features, fixes, and improvements.

If you haven’t already installed Visual Studio 2019, go to the Visual Studio downloads page to install it for free. If you are currently using a different version of Visual Studio, you can either install Visual Studio versions side-by-side, or uninstall previous versions of Visual Studio.

You must log on with an account that has administrative permissions to install, update, or modify Visual Studio. For more information, see User Permissions and Visual Studio.

This topic applies to Visual Studio on Windows. For Visual Studio for Mac, see Update Visual Studio for Mac.

Here’s how to update VisualВ StudioВ 2019.

Use the Visual Studio Installer

Find the Visual Studio Installer on your computer.

In the Windows Start menu, you can search for «installer».

You might have to update the installer before continuing. If so, follow the prompts.

In the installer, look for the edition of Visual Studio that you installed.

For example, if you previously installed VisualВ Studio CommunityВ 2019 and there’s an update for it, then an Update available message appears in the installer.

Choose Update to install the updates.

After the update is complete, you might be asked to restart your computer. If so, do so, and then start Visual Studio as you typically would.

If you aren’t asked to restart your computer, choose Launch to start Visual Studio from the installer.

Use the IDE

You can check for an update and then install it by using the menu bar or the search box in Visual Studio 2019.

Open Visual Studio

From the Windows Start menu, choose Visual Studio 2019.

Under Get started, choose any option to open the IDE.

Visual Studio opens. In the IDE, a Visual Studio 2019 update message appears.

In the Visual Studio 2019 update message, choose View details.

In the Update downloaded and ready to install dialog box, choose Update.

Visual Studio updates, closes, and then reopens.

In Visual Studio

From the menu bar, choose Help, and then choose Check for Updates.

You can also use the search box in the IDE to check for updates. Press Ctrl+Q, type «check for updates», and then choose the search result that matches.

In the Update available dialog box, choose Update.

Visual Studio updates, closes, and then reopens.

Use the Notifications hub

In Visual Studio, save your work.

Choose the notification icon from the lower-right corner of the Visual Studio IDE to open the Notifications hub.

In the Notifications hub, choose the update that you want to install, and then choose View details.

An update for an edition of Visual Studio 2019 is cumulative, so always choose to install the one with the most recent version number.

In the Update available dialog box, choose Update.

Visual Studio updates, closes, and then reopens.

Customize update settings

You can customize the update settings in Visual Studio in several different ways, such as by changing the installation mode and by selecting automatic downloads.

There are two installation modes to choose from:

• Install while downloading
• Download all, then install

You can also choose the Automatically download updates setting, which allows updates to download while your machine is idle.

On the menu bar, choose Tools > Options.

Expand Environment, and then choose Product Updates.

Choose the installation mode and the automatic download options you want for your Visual Studio updates.

Administrator updates

If you are part of an organization that centralizes management of software installations, then your enterprise administrator can cause Visual Studio to update on your machine. For more information on how to control or configure what types of updates your machine can accept, see Using Configuration Manager to deploy Visual Studio Updates.

Get support

Sometimes, things can go wrong. If your Visual Studio installation fails, see Troubleshoot Visual Studio installation and upgrade issues for step-by-step guidance.

We also offer an installation chat (English only) support option for installation-related issues.

Here are a few more support options:

• Report product issues to us via the Report a Problem tool that appears both in the Visual Studio Installer and in the Visual Studio IDE.
• Suggest a feature, track product issues, and find answers in the Visual Studio Developer Community.
• Use your GitHub account to talk to us and other Visual Studio developers in the Visual Studio conversation in the Gitter community.

Обновление сетевой установки Visual Studio Update a network-based installation of Visual Studio

Вы можете обновлять макет сетевой установки Visual Studio до последних обновлений продуктов, что позволяет использовать его не только в качестве точки установки обновлений Visual Studio, но и для поддержки уже развернутых установок на клиентских рабочих станциях. It’s possible to update a network installation layout of Visual Studio with the latest product updates so that it can be used both as an installation point for the latest update of Visual Studio and also to maintain installations that are already deployed to client workstations.

Обновление сетевого макета How to update a network layout

В этих инструкциях предполагается, что макет сетевой установки уже создан. These instructions assume that you’ve previously created a network installation layout. Дополнительные сведения см. на странице Создание сетевой установки Visual Studio. For more information about how to do so, see the Create a network installation of Visual Studio page.

Чтобы обновить общий ресурс сетевой установки и разместить в ней последние обновления, выполните команду —layout для инкрементного скачивания обновленных пакетов. To refresh your network install share so that it includes the latest updates, run the —layout command to incrementally download updated packages.

Если при первоначальном создании сетевого макета вы выбрали частичный макет, эти параметры сохраняются. If you selected a partial layout when you first created the network layout, those settings are saved. Все будущие команды макета используют прежние параметры, а также любые указанные новые параметры. Any future layout commands use the previous options plus any new options that you specify.

Если макет размещается в общей папке, следует обновить закрытую копию макета (например, c:\VSLayout) и только после скачивания всех обновлений скопировать обновленные данные в общую папку (например, \server\products\VS). If you host a layout on a file share, you should update a private copy of the layout (for example, c:\VSLayout) and then, after all of the updated content is downloaded, copy it to your file share (for example, \server\products\VS). В противном случае повышается вероятность, что кто-то из пользователей запустит программу установки во время обновления макета и не сможет получить полное содержимое макета, так как его обновление не завершено. If you don’t do this, there is a greater chance that any users who run Setup while you are updating the layout might not be able to get all of the content from the layout because it is not yet completely updated.

Рассмотрим несколько примеров создания и обновления макета: Let’s walk through a few examples of how to create and then update a layout:

Ниже приведен пример создания макета с одной рабочей нагрузкой только для английского языка. First, here’s an example of how to create a layout with one workload for English only:

Здесь показано, как можно обновить этот же макет до более новой версии. Here’s how to update that same layout to a newer version. Дополнительные параметры командной строки указывать не нужно. You don’t have to specify any additional command-line parameters. Предыдущие параметры были сохранены и будут использоваться во всех последующих командах макета в этой папке макета. The previous settings were saved and will be used by any subsequent layout commands in this layout folder.

Ниже показано, как можно автоматически обновить макет до более поздней версии. Here’s how to update your layout to a newer version in an unattended manner. Операция макета запускает процесс установки в новом окне консоли. The layout operation runs the setup process in a new console window. Это окно остается открытым, так что пользователи могут видеть итоговый результат и сводку ошибок, которые могли произойти. The window is left open so users can see the final result and a summary of any errors that might have occurred. Если вы выполняете автоматическую операцию макета (например, если макет регулярно обновляется до последней версии с помощью скрипта), используйте параметр —passive , чтобы процесс автоматически закрывал окно. If you are performing a layout operation in an unattended manner (for example, you have a script that is regularly run to update your layout to the latest version), then use the —passive parameter and the process will automatically close the window.

Далее показано добавление дополнительной рабочей нагрузки и языка локализации. Here’s how to add an additional workload and localized language. (Эта команда добавляет рабочую нагрузку Разработка Azure.) Теперь в этот макет включены управляемый рабочий стол и Azure. (This command adds the Azure development workload.) Now both Managed Desktop and Azure are included in this layout. Для всех этих рабочих нагрузок также будут включены языковые ресурсы для английского и немецкого языков. The language resources for English and German are also included for all these workloads. И макет обновляется до последней доступной версии. And, the layout is updated to the latest available version.

Операция обновления не устанавливает вновь добавленные дополнительные компоненты. An update operation doesn’t install newly added optional components. Если требуются только что добавленные дополнительные компоненты, удалите старые необязательные компоненты в файле ответов Layout.JSON и включите необходимые компоненты в разделе «Добавление» Layout.JSON . If you need the newly added optional components, please remove the old optional components in the Layout.JSON response file and include the components you need in the «add» section of Layout.JSON .

Инструкции по решению: запустите отдельную операцию изменения после обновления, чтобы установить отсутствующие компоненты. Workaround: Run a separate modify operation after an upgrade to install the missing components.

Наконец, вот как можно добавить дополнительную нагрузку и язык локализации без обновления версии. And finally, here’s how to add an additional workload and localized language without updating the version. (Эта команда добавляет рабочую нагрузку Разработка ASP.NET и веб-приложений.) Теперь в этот макет включены рабочие нагрузки управляемого рабочего стола, Azure и ASP.NET и разработки веб-приложений. (This command adds the ASP.NET and web development workload.) Now the Managed Desktop, Azure, and ASP.NET & Web Development workloads are included in this layout. Для всех этих рабочих нагрузок также включены языковые ресурсы для английского, немецкого и французского языков. The language resources for English, German, and French are also included for all these workloads. Но при выполнении этой команды макет не был обновлен до последней доступной версии. However, the layout was not updated to the latest available version when this command was run. Он остается в существующей версии. It remains at the existing version.

Развертывание обновления на клиентских компьютерах Deploy an update to client machines

В зависимости от настроек сетевой среды обновление могут разворачивать администраторы предприятия или пользователи с клиентского компьютера. Depending on how your network environment is configured, an update can either be deployed by an enterprise administrator or initiated from a client machine.

• Пользователи могут обновлять экземпляр Visual Studio, установленный из папки установки в автономном режиме. Users can update a Visual Studio instance that was installed from an offline installation folder:
  • Запустите установщик Visual Studio. Run the Visual Studio Installer.
  • Затем нажмите кнопку Обновить. Then, click Update.

• Администраторы могут обновлять клиентские развертывания Visual Studio без взаимодействия с пользователем, выполняя две отдельные команды. Administrators can update client deployments of Visual Studio without any user interaction with two separate commands:
  • Сначала нужно обновить установщик Visual Studio: First, update the Visual Studio installer:
    vs_enterprise.exe —quiet —update
  • Теперь обновите само приложение Visual Studio: Then, update the Visual Studio application itself:
    vs_enterprise.exe update —installPath «C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise» —quiet —wait —norestart

• Администраторы могут обновлять клиентские развертывания Visual Studio без взаимодействия с пользователем, выполняя две отдельные команды. Administrators can update client deployments of Visual Studio without any user interaction with two separate commands:
  • Сначала нужно обновить установщик Visual Studio: First, update the Visual Studio installer:
    vs_enterprise.exe —quiet —update
  • Теперь обновите само приложение Visual Studio: Then, update the Visual Studio application itself:
    vs_enterprise.exe update —installPath «C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise» —quiet —wait —norestart

Используйте команду vswhere.exe, чтобы узнать путь установки существующего экземпляра Visual Studio на клиентском компьютере. Use the vswhere.exe command to identify the install path of an existing instance of Visual Studio on a client machine.

Дополнительные сведения о настройке уведомлений пользователям об обновлениях есть в статье Control updates to network-based Visual Studio deployments (Управление обновлениями для сетевых развертываний Visual Studio). For details on how to control when update notifications are presented to users, see Control updates to network-based Visual Studio deployments.

Проверка макета Verify a layout

Используйте команду —verify для выполнения проверки в предоставленном автономном кэше. Use —verify to perform verification on the offline cache supplied. Она проверяет отсутствующие или недопустимые файлы пакетов. It checks if packages files are either missing or invalid. В конце проверки выводится список отсутствующих и недопустимых файлов. At the end of the verification, it prints the list of missing files and invalid files.

vs_enterprise.exe можно вызвать внутри layoutDir. The vs_enterprise.exe can be invoked inside the layoutDir.

В автономном кэше макета должны находиться некоторые важные файлы метаданных, которые требуются параметру —verify . Some important metadata files that are needed by the —verify option must be in the layout offline cache. Если эти файлы метаданных отсутствуют, команду «—verify» выполнить невозможно, и программа установки сообщит об ошибке. If these metadata files are missing, «—verify» cannot run and Setup gives you an error. При возникновении этой ошибки повторно создайте автономный макет в другой папке (или в той же папке автономного кэша). If you experience this error, re-create a new offline layout to a different folder (or to the same offline cache folder. Для этого выполните ту же команду макета, которая использовалась для создания первоначального автономного макета. To so do, run the same layout command that you used to create the initial offline layout. Например, vs_enterprise.exe —layout . For example, vs_enterprise.exe —layout .

Корпорация Майкрософт периодически предоставляет обновления для Visual Studio, поэтому версия нового создаваемого макета может отличаться от версии первоначального макета. Microsoft ships updates to Visual Studio periodically, so the new layout that you create might not be the same version as the initial layout.

Проверка работает только для последней версии определенного дополнительного номера версии Visual Studio. Verification works only for the latest version of a specific minor version of Visual Studio. Сразу после выпуска новой версии проверка не будет работать для более ранних выпусков уровня исправлений того же дополнительного номера версии. As soon as a new version is released, verification won’t work for earlier patch level releases of the same minor version.

Исправление ошибок макета Fix a layout

Используйте команду —fix для выполнения той же проверки, что и —verify , а также попытайтесь устранить выявленные проблемы. Use —fix to perform the same verification as —verify and also try to fix the identified issues. Для процесса —fix требуется подключение к Интернету, поэтому перед вызовом —fix убедитесь, что компьютер подключен к Интернету. The —fix process needs an internet connection, so make sure your machine is connected to the internet before you invoke —fix .

vs_enterprise.exe можно вызвать внутри layoutDir. The vs_enterprise.exe can be invoked inside the layoutDir.

Удаление предыдущих версий из макета Remove older versions from a layout

После применения обновлений макета к автономному кэшу в папке кэша макета может находиться ряд устаревших пакетов, которые больше не требуются в последней установке Visual Studio. After you perform layout updates to an offline cache, the layout cache folder may have some obsolete packages that are no longer needed by the latest Visual Studio installation. Используйте параметр —clean , чтобы удалить устаревшие пакеты из папки автономного кэша. You can use the —clean option to remove obsolete packages from an offline cache folder.

Для этого вам потребуются пути к файлам к манифестам каталога, содержащим эти устаревшие пакеты. To do this, you’ll need the file path(s) to catalog manifest(s) that contain those obsolete packages. Манифесты каталога можно найти в папке «Archive» в автономном кэше макета. You can find the catalog manifests in an «Archive» folder in the offline layout cache. Они сохраняются там при обновлении макета. They are saved there when you update a layout. В папке «Archive» находится одна или несколько папок «GUID», каждая из которых содержит устаревший манифест каталога. In the «Archive» folder, there is one or more «GUID» named folders, each of which contains an obsolete catalog manifest. Количество папок «GUID» должно совпадать с количеством обновлений, внесенных в автономный кэш. The number of «GUID» folders should be the same as the number of updates made to your offline cache.

Внутри каждой папки «GUID» сохранено несколько файлов. A few files are saved inside each «GUID» folder. Наибольший интерес представляют два файла — файл «version.txt» и файл «catalog.json». The two files of most interest are a «catalog.json» file and a «version.txt» file. Файл «catalog.json» является устаревшим манифестом каталога, который потребуется для передачи в параметр —clean . The «catalog.json» file is the obsolete catalog manifest you’ll need to pass to the —clean option. Другой файл («version.txt») содержит версию этого устаревшего манифеста каталога. The other version.txt file contains the version of this obsolete catalog manifest. На основе номера версии можно решить, следует ли удалять устаревшие пакеты из этого манифеста каталога. Based on the version number, you can decide whether you want to remove obsolete packages from this catalog manifest. То же самое можно сделать при переходе по другим папкам «GUID». You can do the same as you go through the other «GUID» folders. Приняв решение по поводу каталогов, которые необходимо очистить, выполните команду —clean , указав пути к файлам в этих каталогах. After you make the decision on the catalog(s) you want to clean, run the —clean command by supplying the files paths to these catalogs.

Далее приведены несколько примеров использования параметра —clean. Here are a few examples of how to use the —clean option:

vs_enterprise.exe можно также вызвать внутри . You can also invoke vs_enterprise.exe inside the . Ниже приведен пример: Here’s an example:

При выполнении этой команды программа установки анализирует папку автономного кэша, чтобы найти список файлов, которые будут удалены. When you execute this command, Setup analyzes your offline cache folder to find the list of files that it will remove. Затем вы сможете просмотреть файлы, которые будут удалены, и подтвердить удаление. You will then have a chance to review the files that are going to be deleted and confirm the deletions.

Техническая поддержка по вопросам, связанным с автономным установщиком Get support for your offline installer

Если что-то во время автономной установки возникнет проблема, мы очень хотим узнать об этом. If you experience a problem with your offline installation, we want to know about it. Передайте нам информацию с помощью средства сообщения о проблеме. The best way to tell us is by using the Report a Problem tool. Это средство позволяет отправлять нам данные телеметрии и журналы, которые помогут диагностировать и устранить возникшую проблему. When you use this tool, you can send us the telemetry and logs we need to help us diagnose and fix the problem.

Также доступен чат поддержки в реальном времени, предназначенный для оказания помощи при проблемах с установкой (только на английском языке). We also offer a live chat (English only) support option for installation-related issues.

У нас есть и другие возможности технической поддержки. We have other support options available, too. Список можно найти на нашей странице отзывов. For a list, see our Feedback page.