Установка .NET в Windows

В этой статье вы узнаете, как установить .NET в Windows. .NET состоит из среды выполнения и пакета SDK. Среда выполнения используется для запуска приложения .NET и может не включаться в состав приложения. Пакет SDK используется для создания приложений и библиотек .NET. Среда выполнения .NET всегда устанавливается вместе с пакетом SDK.

.NET 5.0 является последней версией.

Поддерживаемые выпуски

В приведенной ниже таблице содержится список поддерживаемых сейчас выпусков .NET и версий Windows, в которых они поддерживаются. Эти версии поддерживаются до окончания поддержки версии .NET, либо до окончания жизненного цикла версии Windows.

Даты окончания жизненного цикла версий Windows 10 зависят от выпуска. В следующей таблице рассматриваются только выпуски Домашняя, Профессиональная, Pro для образовательных учреждений и Pro для рабочих станций. Дополнительные сведения см. в справочных материалах по жизненному циклу поддержки Windows.

Совет

Символ + представляет минимальную версию.

Операционная система .NET Core 2.1 .NET Core 3.1 .NET 5
Windows 11 ✔️ ✔️
Windows Server 2022 ✔️ ✔️
Windows 10, версия 21H1 ✔️ ✔️ ✔️
Windows 10 или Windows Server версии 20H2 ✔️ ✔️ ✔️
Windows 10 или Windows Server версии 2004 ✔️ ✔️ ✔️
Windows 10 или Windows Server версии 1909 ✔️ ✔️ ✔️
Windows 10 или Windows Server версии 1903 ✔️ ✔️ ✔️
Windows 10, версия 1809 ✔️ ✔️ ✔️
Windows 10, версия 1803 ✔️ ✔️ ✔️
Windows 10, версия 1709 ✔️ ✔️ ✔️
Windows 10 (версия 1607) ✔️ ✔️ ✔️
Windows 8.1 ✔️ ✔️ ✔️
Windows 7 с пакетом обновления 1 (SP1), ESU ✔️ ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ ✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️ ✔️
Nano Server, версия 1809 и выше ✔️ ✔️ ✔️
Nano Server, версия 1803 ✔️ ✔️

Неподдерживаемые выпуски

Следующие версии .NET больше не поддерживаются (❌).

  • 3.0
  • 2.2
  • 2.0

Сведения о среде выполнения

Среда выполнения используется для запуска приложений, созданных с помощью .NET. При публикации приложения автор может включить среду выполнения в его состав. В противном случае устанавливать среду выполнения будет пользователь.

В Windows можно установить три различные версии среды выполнения:

  • Среда выполнения ASP.NET Core
    Используется для запуска приложений ASP.NET Core. Включает среду выполнения .NET.

  • Среда выполнения для классических приложений
    Используется для запуска классических приложений .NET WPF и Windows Forms для Windows. Включает среду выполнения .NET.

  • Среда выполнения .NET
    Простейшая среда выполнения, в состав которой не входят какие-либо другие среды выполнения. Чтобы обеспечить максимальный уровень совместимости с приложениями .NET, настоятельно рекомендуется устанавливать среду выполнения ASP.NET Core и среду выполнения для классических приложений.

Сведения о пакете SDK

Пакет SDK используется для создания и публикации приложений и библиотек .NET. При установке пакета SDK также устанавливаются все три среды выполнения: ASP.NET Core, компьютер и .NET.

Зависимости

.NET 5.0 поддерживает следующие версии Windows:

Примечание

Символ + представляет минимальную версию.

Операционная система Version Архитектуры
Windows 11 21H2 x64, ARM64
Клиент Windows 10 1607+ x64, x86, ARM64
Клиент Windows 7 с пакетом обновления 1 и более поздних версий (SP1+), 8.1 x64, x86
Windows Server 2012+ x64, x86
Windows Server Core 2012+ x64, x86
Nano Server 1809+ X64

Дополнительные сведения об операционных системах, дистрибутивах и политике жизненного цикла, поддерживаемых .NET 5.0, см. в статье Поддерживаемые .NET 5.0 версии ОС.

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

При установке пакета SDK для .NET или среды выполнения .NET в следующих версиях Windows требуются дополнительные зависимости:

Операционная система Предварительные требования
Windows 7 с пакетом обновления 1 (SP1), ESU – Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный
– Обновление KB3063858, 64-разрядное / 32-разрядное
- Центр корневой сертификации Microsoft 2011 (только удаленный установщик .NET Core 2.1)
Windows Vista с пакетом обновления 2 (SP2) Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный
Windows 8.1 Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный
Windows Server 2008 R2 Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный
Windows Server 2012 Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный
Windows Server 2012 R2 Распространяемый компонент Microsoft Visual C++ 2015–2019, 64-разрядный / 32-разрядный

Приведенные выше требования также применяются, если возникает ошибка, связанная с любой из следующих библиотек DLL:

  • api-ms-win-crt-runtime-l1-1-0.dll
  • api-ms-win-cor-timezone-l1-1-0.dll
  • hostfxr.dll

Установка с помощью функции автоматизации PowerShell

Сценарии dotnet-install используются для автоматизации непрерывной интеграции и ее осуществления без прав администратора. Вы можете скачать сценарий со страницы справочника по сценариям dotnet-install.

Этот сценарий по умолчанию устанавливает последнюю версию с долгосрочной поддержкой (LTS), которой сейчас является .NET Core 3.1. Вы можете выбрать конкретный выпуск, указав параметр Channel. Включите параметр Runtime для установки среды выполнения. В противном случае сценарий устанавливает пакет SDK.

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

Установите пакет SDK, опустив параметр -Runtime. В этом примере для параметра -Channel задано значение Current, которое определяет установку последней поддерживаемой версии.

dotnet-install.ps1 -Channel Current

Установка с помощью Visual Studio

Если вы используете Visual Studio для разработки приложений .NET, в следующей таблице указана минимальная требуемая версия Visual Studio на основе целевой версии пакета SDK для .NET.

Версия пакета SDK для .NET Версия Visual Studio
5,0 Visual Studio 2019 версии 16.8 или более поздней.
3.1 Visual Studio 2019 версии 16.4 или более поздней.
3.0 Visual Studio 2019 версии 16.3 или более поздней.
2.2 Visual Studio 2017 версии 15.9 или более поздней.
2.1 Visual Studio 2017 версии 15.7 или более поздней.

Если среда Visual Studio уже установлена, вы можете проверить ее версию, выполнив указанные ниже действия.

  1. Запустите Visual Studio.
  2. Выберите Справка > О Microsoft Visual Studio.
  3. Считайте номер версии из диалогового окна О программе.

Visual Studio может установить последнюю версию пакета SDK для .NET и среды выполнения .NET.

Выбор рабочей нагрузки

При установке или изменении Visual Studio выберите одну или несколько из следующих рабочих нагрузок в зависимости от типа создаваемого приложения:

  • рабочая нагрузка Кроссплатформенная разработка .NET Core в разделе Другие наборы инструментов;
  • рабочая нагрузка ASP.NET и разработка веб-приложений в разделе Веб-разработка и облако;
  • рабочая нагрузка Разработка для Azure в разделе Веб-разработка и облако;
  • рабочая нагрузка Разработка классических приложений .NET в разделе Классические и мобильные.

Windows Visual Studio 2019 с рабочей нагрузкой .NET Core

Установка вместе с Visual Studio Code

Visual Studio Code — это эффективный и облегченный редактор исходного кода, который работает на компьютере. Visual Studio Code доступен для Windows, macOS и Linux.

Хотя Visual Studio Code не поставляется с автоматическим установщиком .NET Core, таким как Visual Studio, добавление поддержки .NET Core не вызывает затруднений.

  1. Скачайте и установите Visual Studio Code.
  2. Скачайте и установите пакет SDK для .NET Core.
  3. Установите расширение C# из Marketplace для Visual Studio Code.

Установщик Windows

Страница загрузки для .NET содержит исполняемые файлы установщика Windows.

При использовании установщиков Windows для установки .NET вы можете указать путь установки, задав параметры DOTNETHOME_X64 и DOTNETHOME_X86.

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

Для установки .NET в автоматическом режиме, например, в рабочей среде, или для поддержки непрерывной интеграции, используйте следующие параметры:

  • /install
    Устанавливает .NET.

  • /quiet
    Предотвращает отображение любого пользовательского интерфейса и запросов.

  • norestart
    Предотвращает все попытки перезапуска.

dotnet-sdk-3.1.301-win-x64.exe /install /quiet /norestart

Дополнительные сведения смотрите в статье Параметры командной строки стандартного установщика.

Совет

В случае успешной установки установщик возвращает код 0; если требуется перезагрузка, установщик возвращает код 3010. Любое другое значение обычно является кодом ошибки.

Скачивание и установка вручную

В качестве альтернативы установщикам Windows для .NET можно скачать и вручную установить пакет SDK или среду выполнения. Установка вручную как правило выполняется в рамках тестирования непрерывной интеграции. В большинстве случаев разработчикам и пользователям рекомендуется использовать установщик.

Как пакет SDK для .NET, так и среду выполнения .NET можно установить вручную после скачивания. При установке пакета SDK для .NET не нужно устанавливать соответствующую среду выполнения. Сначала скачайте двоичный выпуск пакета SDK или среды выполнения с одного из следующих сайтов:

Создайте каталог, в который будет выполнено извлечение .NET, например %USERPROFILE%\dotnet. Затем извлеките скачанный ZIP-файл в этот каталог.

По умолчанию команды и приложения .NET CLI не будут использовать платформу .NET, установленную таким образом. Вам нужно выбрать ее явно. Для этого измените переменные среды, с которыми запускается приложение:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

Такой подход позволяет установить несколько версий в отдельные расположения, а затем явно выбрать расположение установки, которое должно использовать приложение, запустив приложение с переменными среды, указывающими на это расположение.

Если параметр DOTNET_MULTILEVEL_LOOKUP имеет значение 0, .NET игнорирует любые установленные глобально версии .NET. Если нужно, чтобы платформа .NET учитывала глобальное расположение установки по умолчанию при выборе лучшей платформы для запуска приложения, удалите этот параметр среды. По умолчанию обычно используется каталог C:\Program Files\dotnet, в который выполняется установка .NET при использовании установщика.

Docker

Контейнеры обеспечивают простой способ изоляции приложения от остальной части основной системы. Контейнеры на одном компьютере совместно использую только ядро, а также используют ресурсы, которые передаются в приложение.

.NET можно выполнять в контейнере Docker. Официальные образы Docker для .NET публикуются в реестре контейнеров Microsoft (MCR), и доступ к ним можно получить в репозитории Microsoft .NET Docker Hub. Каждый репозиторий содержит рабочие образы для разных сочетаний .NET (пакета SDK или среды выполнения) и операционной системы.

Корпорация Майкрософт предоставляет образы, которые предназначены для конкретных сценариев. Например репозиторий ASP.NET Core содержит образы, которые предназначены для запуска приложений ASP.NET Core в рабочей среде.

Дополнительные сведения об использовании .NET в контейнере Docker см. в статьях Введение в .NET и Docker и Примеры.

Дальнейшие действия